Composer 默认不检查本地 PHP 扩展,仅依据 composer.json 中的 platform 配置或运行时环境判断兼容性;需显式声明如 "php": "8.3.12" 和 "ext-pdo_mysql": "8.3.12" 等精确版本以收窄依赖候选集,避免 SAT 求解器穷举导致解析变慢。

Composer 依赖解析不查本地扩展,这是默认行为
Composer 默认不会检查你系统里已装的 PHP 扩展(比如 gd、mbstring、xml),而是靠 composer.json 中的 platform 配置或运行时环境来判断兼容性。它只在解析阶段“假设”这些扩展存在或不存在,不实际调用 extension_loaded() 去验证。所以即使你本地全装齐了,Composer 仍可能因锁文件里记录的 platform 版本过旧、或没声明 config.platform.php,反复回退到低版本包候选集——导致 SAT 求解器穷举更多组合,拖慢 Resolving dependencies。
用 config.platform 声明真实环境,收窄候选包范围
真正起效的方式是显式告诉 Composer:“我这台机器上跑的是 PHP 8.3,且已启用 opcache、pdo_mysql、json”。这样它就不会为兼容 PHP 7.4 或无 pdo 的场景保留老版本包。
- 在项目
composer.json的"config"段加:"platform": { "php": "8.3.12", "ext-gd": "8.3.12", "ext-mbstring": "8.3.12", "ext-pdo_mysql": "8.3.12" } - 注意:值写具体版本号(如
"8.3.12")比写"*"更可靠;Composer 会按字面匹配,"*"可能被忽略或触发宽松校验 - PHP 版本必须和
php -v输出一致,否则composer install会报Your requirements could not be resolved,哪怕扩展都装了 - 不要只写
"ext-opcache": "true"—— Composer 不认布尔值,必须是版本号格式(如"8.3.12")或留空(表示“存在但不指定版本”)
为什么跳过 --ignore-platform-reqs 后反而更慢
很多人在 CI 或本地装不上时习惯加 --ignore-platform-reqs,但这会让 Composer 完全绕过 platform 约束,退回到“兼容所有 PHP 版本 + 所有扩展可选”的最宽泛策略。结果就是:原本只需考虑 PHP 8.3 兼容的 5 个包版本,现在得穷举 PHP 7.2–8.3 全系 + 有/无 gd/mbstring 的 20+ 组合——SAT 求解时间指数级上升。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- CI 脚本里出现
--ignore-platform-reqs,基本等于主动放弃依赖剪枝 - 真正该做的是统一 CI 环境的 PHP 版本和扩展,并在
composer.json中精确声明platform - 开发机上若用 Docker,确保
php -m输出和config.platform一致;Mac 上通过 Homebrew 装的 PHP,常缺pdo_pgsql,但config.platform写了就会误判
autoload 和 platform 无关,但扩展缺失会导致 dump-autoload 失败
config.platform 只影响依赖解析阶段,不影响自动加载。但如果你的代码用了 json_encode(),而 config.platform 没声明 ext-json,Composer 可能选了一个不带 JSON 支持的旧版包;等 composer dump-autoload 运行时,类里调用 json_encode() 就直接 fatal error——这不是解析慢,是后续执行崩了。
- 扩展声明不是“可选项”,而是“契约”:你写了
"ext-json": "8.3.12",就代表代码里可以放心用 JSON 函数 - 新增扩展后(比如刚
pecl install xdebug),必须同步更新config.platform并运行composer update --lock,否则 lock 文件仍按旧平台生成 -
composer show --platform可查看当前生效的 platform 声明,比翻composer.json更直观
platform 配置不是性能开关,而是约束声明——它让 Composer 少做无效推理。写得越贴近真实环境,解析越快;写得模糊或错误,反而逼它兜底穷举。别指望它自动发现你装了什么,它只信你写的那几行。

















