Composer如何通过使用系统本地已安装的扩展提升依赖解析效率（技巧分享）-composer-PHP中文网

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

composer如何通过使用系统本地已安装的扩展提升依赖解析效率（技巧分享）

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 Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 少做无效推理。写得越贴近真实环境，解析越快；写得模糊或错误，反而逼它兜底穷举。别指望它自动发现你装了什么，它只信你写的那几行。