Composer中文新手避坑100例？从入门到精通的配置避坑指南-composer-PHP中文网

composer装完但跑不起来，主因是php环境（≥8.0且启用openssl/zlib/json/mbstring）、path路径、阿里云镜像未配置或autoload.php未用__dir__绝对路径引入；务必执行composer diagnose验证。

composer中文新手避坑100例？从入门到精通的配置避坑指南

Composer 不是装完 composer --version 显示数字就万事大吉的工具——90% 的“装了但跑不起来”问题，都卡在 PHP 环境、路径、镜像或 autoload.php 引入方式这四点上。

PHP 版本和扩展没对齐，`composer install` 会静默失败

常见错误现象：Could not open input file: composer.phar（实际是 PHP 解析器不兼容）、Failed to decode response（缺 openssl 或 zlib）、Your requirements could not be resolved（PHP 版本低于 composer.lock 中声明的最低要求）。

Composer 2.5+ 要求 PHP ≥ 8.0，且必须启用 openssl、zlib、json、mbstring 四个扩展——缺一不可
验证命令必须按顺序执行：php -v（确认含 NTS 且版本 ≥ 8.0）、php -m | grep -E "(openssl|zlib|json|mbstring)"
Windows 下用 PHPStudy/XAMPP 时，php -v 和 composer --version 可能调用不同 PHP，唯一可信检查是 composer diagnose

`vendor/autoload.php` 必须用 `DIR` 引入，不能写相对路径

错误写法：require './vendor/autoload.php'; 或 require 'vendor/autoload.php'; —— 一旦通过 CLI 执行、Nginx 配置别名、或被其他文件 include，立刻报 Class not found。

Discussion Composer

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

下载

所有入口文件（index.php、cli.php、phpunit 启动脚本）第一行且仅此一行，必须是：require __DIR__ . '/vendor/autoload.php';
不能有任何输出（包括 session_start()、echo、BOM 字节）在这行之前，否则自动加载注册失败
老项目无命名空间？别硬改代码，改 composer.json 的 "autoload": {"classmap": ["lib/", "includes/"]}，再跑 composer dump-autoload

国内网络下 `composer install` 卡住，本质是镜像没切对

卡在 Loading composer repositories 或 Downloading https://packagist.org/packages.json，不是网速慢，是直连 packagist.org 被墙。

全局配置阿里云镜像（推荐）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
项目级配置（适合多源协作）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
切完镜像后务必运行 composer diagnose，确认 Repo packagist is using the default value 已消失，且 HTTP proxy 和 CA bundle 检查通过
PHPStudy 用户注意：若 diagnose 报 SSL certificate problem，需打开 PHP 配置，取消注释并修正 curl.cainfo 指向正确的 CA 文件路径

`composer install` 和 `composer update` 混用，线上环境必崩

团队里有人偷偷 update 并提交新 composer.lock，其他人 install 出来行为不一致，却查不出原因——这是最隐蔽也最致命的坑。

composer install：只读 composer.lock，还原完全一致的依赖树 → 适用于 git clone、CI/CD、线上部署
composer update：忽略 lock，重新解析 composer.json → 仅用于本地开发加依赖或升级小版本
加新包必须用 composer require monolog/monolog:^3.0（带 ^），它会自动 update 并更新 lock；别手动 update 后再 require
CI/CD 流水线里禁止出现 composer update，哪怕加了 --no-dev —— 锁文件才是环境契约