Composer install校验PHP版本只看当前shell中php命令的真实版本，即php -v输出结果，而非config.platform.php或composer.json中的"php"约束；必须确保which php与composer diagnose中PHP binary路径一致，否则依赖解析和autoload生成将错位。
composer install 时 PHP 版本校验到底看哪个？
它只看当前 shell 中 php 命令的真实版本，不是 config.platform.php，也不是 composer.json 里写的 "php": "^8.1"。运行 php -v 输出什么，Composer 就拿什么去比对约束。
常见错误现象：
-
composer install报错This package requires php ^8.1 but your PHP version (7.4.33) does not satisfy that requirement - 本地
php -v是 7.4，但 CI 脚本里没显式指定路径，结果用了系统默认的 8.2，构建通过、上线却报ParseError: unexpected token "match"
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Linux/macOS 下统一用完整路径调用：
/usr/bin/php8.1 composer install - Windows 下必须写全路径：
"C:\php\php81\php.exe" composer install - CI 脚本开头加
php -v和which php（Linux/macOS）或where php（Windows）打日志，确认实际执行环境 - 不要依赖
update-alternatives或 Homebrew 切换全局 PHP——它会影响其他项目甚至系统工具
platform 配置只在 update 阶段生效，install 不会重算
config.platform.php 是个“声明式欺骗”，它只在 composer update 时影响依赖求解器，告诉 Composer：“就当这台机器只有 PHP 7.4.33 和这些扩展”。但它对 composer install 完全无效——后者只照 composer.lock 还原，不管 platform 写了啥。
常见错误现象：
- 改了
composer.json的config.platform，但没跑composer update --with-all-dependencies，composer install在旧环境仍失败 - 团队共用一份
composer.lock，有人用 PHP 8.2 生成，其他人用 7.4install成功但运行时报Class not found（因为 lock 里锁的是 8.1+ 兼容包）
实操建议：
-
config.platform必须写精确小版本号，如"php": "7.4.33"，不能写"^7.4"或"7.4" - 所有项目代码中用到的扩展都得列全：
"ext-mbstring": "7.4.33"、"ext-pdo_mysql": "7.4.33"等 - 改完 platform 后，必须执行
composer update --with-all-dependencies重写composer.lock，否则无意义 - 该配置不应提交到团队仓库，除非所有人目标平台完全一致（极少见）
多终端下镜像源配置失效的三个硬条件
镜像源不生效，不是 Composer “抽风”，而是三个格式条件缺一不可：键名必须是 repo.packagist（单数、全小写）、type 值必须显式写 "composer"、URL 必须以 https:// 开头且末尾带 /。任一不满足，Composer 2.x+ 就静默 fallback 到 packagist.org。
常见错误现象：
- Windows 下用
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，但没重启 PowerShell，配置未加载 - Linux 下用
sudo composer config -g ...，结果写进 root 的~/.composer/config.json，普通用户运行时读不到 - 项目已有
"repositories": []（数组），命令直接失败，没提示
实操建议：
- 优先用项目级配置：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 执行前确保
composer.json中"repositories"是对象而非数组，否则手动改为"repositories": {} - 务必加
"packagist.org": false到composer.json根节点，防 Composer 2.2+ fallback - 换镜像后先清缓存：
composer clear-cache，再删vendor和composer.lock重来
跨平台版本约束冲突要靠 why-not 定位，不是靠猜
当 composer install 或 update 报 Conclusion: don't install xxx v2.3.0，说明依赖树无解。这不是语法错误，而是多个包对同一依赖提出了互斥要求（比如 A 要 ^2.0，B 锁死 1.26.1）。Composer 不会自动降级，得你指出边界。
实操建议：
- 先查阻塞源：
composer why-not monolog/monolog:2.9.0，看哪条依赖链在阻止 - 再查全路径：
composer prohibits monolog/monolog:2.9.0，确认是否被间接依赖卡死 - 如果确定要锁定旧版，用
composer require monolog/monolog:1.26.1 --no-update改composer.json，再composer update monolog/monolog单独重算 - 避免
composer update --with-all-dependencies直接上——它可能把guzzlehttp/guzzle从 7.x 升到 8.x，而你的代码还用着new GuzzleHttp\Client()
真正容易被忽略的点是：冲突往往藏在传递依赖里，composer show -t 比肉眼扫 composer.json 有用得多；另外，composer.lock 一旦生成，就固化了所有版本决策，跨平台协作时它比 composer.json 更关键。
