composer环境搭建及入门教程_一篇文章学会composer使用【全书】-composer-PHP中文网

composer 需匹配 php 版本（≥8.0）与扩展（openssl/zlib/json/mbstring），禁用 git bash 运行，换阿里云镜像源解决网络问题，勿删 composer.lock，版本号需锁死，autoload 修改后须执行 dump-autoload。

composer环境搭建及入门教程_一篇文章学会composer使用【全书】

Composer 不是“装上就能用”的工具，它依赖 PHP 环境和网络策略，本地装完却跑不起来 composer install 是最常见失败起点。

PHP 版本和扩展没配对，`composer` 命令直接报错

Composer 从 2.5 开始最低要求 PHP 8.0，但很多老项目还在用 PHP 7.4，强行升级会触发 ParseError 或 TypeError；反过来，用太旧的 Composer（如 1.x）装新包，又可能因不支持 platform-check 或 lock file version 3 失败。

先确认 PHP 版本：php -v，再查 Composer 官方兼容表（不是看文档首页，要看 https://getcomposer.org/doc/00-intro.md#installation-linux-unix-macos 底部小字）
必须启用 openssl、zlib、json、mbstring 四个扩展，缺一个就卡在 Could not open input file: composer.phar 这类假错误里
Windows 用户注意：别用 Git Bash 直接运行 php composer.phar，它会把路径解析成 /c/Users/xxx 格式导致找不到 autoload.php，改用 PowerShell 或 CMD

`composer install` 卡住或报 `Failed to decode response`

这不是 Composer 本身坏了，而是它默认走 packagist.org，国内访问不稳定，DNS 污染、TLS 握手超时、中间代理截断响应都可能导致这个错误——尤其在 CI 环境或公司内网。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

临时解决：加 -vvv 参数看卡在哪一步，大概率停在 Downloading https://packagist.org/packages.json
永久方案：换镜像源，但别用网上搜到的过期地址（比如 https://packagist.phpcomposer.com 已停服），现在稳定的是阿里云：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
如果项目已有 composer.lock，别轻易删掉重装；install 是按 lock 文件精确还原，update 才会重新解析依赖树——混用会导致环境不一致

require 的包版本写法不对，`composer update` 装了不该装的东西

版本号不是越新越好。^2.0 允许升到 2.9.9，但某些包的 2.5.0 引入了 PHP 8.1 特性，你 PHP 8.0 就直接崩；~1.2.3 表示只允许补丁更新，可一旦作者把 1.2.4 写成破坏性更新，照样翻车。

生产环境永远用 composer require vendor/name:1.2.3 锁死小版本，别留 ^ 或 ~
开发时想试新功能，先 composer require vendor/name:dev-main --dev，但得确认对方 main 分支有 autoload-dev 配置，否则 vendor/autoload.php 不加载测试类
遇到 your requirements could not be resolved，不是依赖冲突严重，往往是某个包的 composer.json 里写了 "php": ">=8.2"，而你本地是 8.1——用 composer show vendor/name 查它的 require 约束

autoload 自定义失效，`new ClassName()` 报 `Class not found`

Composer 只自动加载 psr-4 和 psr-0 配置里的命名空间，手写的工具函数、全局常量、.php 文件里的裸代码，它一概不管。很多人以为改完 composer.json 就行，忘了最关键的一步。

新增 "autoload": {"files": ["src/helpers.php"]} 后，必须运行 composer dump-autoload，否则 vendor/autoload.php 里还是没这行 require
psr-4 映射路径不能带 ./ 或 ../，写成 "App\": "app/" 对，写成 "App\": "./app/" 就加载失败——Composer 解析时会把点斜杠当字面量拼进路径
如果项目用了 classmap（比如 legacy 代码），记得每次增删文件后手动 composer dump-autoload -o，不然 classmap 缓存不会自动更新

Composer 的坑不在命令多难记，而在每一步都隐含环境假设：PHP 版本、扩展开关、网络可达性、锁文件状态、autoload 缓存是否刷新。漏掉其中任何一个，错误信息都不会直说“你少开了 openssl”，只会甩一句 Script @php artisan package:discover handling the post-autoload-dump event returned with error code 255——这种链式报错，得一层层往回扒日志。