Composer运行慢主因是本地配置错误、缓存未清及关键参数缺失;在PHP 8.2+和Composer 2.5+下,开关设置不当会使install耗时增2–3倍。

Composer 运行慢,95% 不是网络问题,而是本地配置错、缓存没清、关键参数漏加——尤其在 PHP 8.2+ 和 Composer 2.5+ 环境下,几个开关一错,composer install 就会多耗 2–3 倍时间。
为什么 composer install 卡在 “Resolving dependencies”
这不是在下载,是 Composer 在本地穷举所有满足约束的版本组合。约束越宽(比如 "monolog/monolog": "*" 或 "^1.0 || ^2.0"),求解时间越容易从秒级跳到分钟级。
- 删掉
"minimum-stability": "dev":dev 包极大扩充候选集,稳定版能直接砍掉 70%+ 的搜索空间 - 确认没启用 Xdebug:它会让解析慢 5–10 倍;临时禁用命令是
php -d zend_extension= -d xdebug.mode=off /usr/bin/composer install - 避免
--with-all-dependencies或--ignore-platform-reqs:它们绕过缓存,强制全量重算,不是提速,是自废武功 - 想快速定位冲突?用
composer why-not vendor/package:version,比干等强得多
composer install 卡在 “Installing dependencies” 怎么办
这个阶段卡住,基本是下载或解压问题,和依赖解析无关。常见于低内存容器、WSL2 挂载卷、或并发数设太高。
- 限制并发下载数:
composer config -g http-max-concurrent-downloads 8(默认是 6,设成 20 容易触发file_put_contents(/tmp/): failed to open stream) - 换镜像源后必须执行
composer clear-cache——否则旧缓存仍走 packagist.org,提速效果打折扣 - 禁用 CLI 模式下的
opcache.enable_cli=1(PHP 8.2+ 中它反而拖慢 Composer 自身加载) - 删掉已废弃的
fxp/composer-asset-plugin插件,它会严重干扰依赖解析流程
生产环境部署必加的四个参数
CI/CD 或线上构建中,漏掉任意一个都可能让 composer install 多花 30%–60% 时间。
-
--no-dev:跳过require-dev下所有包(如phpunit、phpstan),也防止测试类污染autoload_classmap.php -
--prefer-dist:强制走 ZIP 包安装,避免 Git 克隆开销;对私有仓库也有效(只要提供 dist URL) -
--optimize-autoloader(或-o):生成vendor/composer/autoload_classmap.php,跳过运行时路径拼接和file_exists()调用 -
--classmap-authoritative:告诉 autoloader “类不在 classmap 里就别找了”,彻底关闭 fallback,高并发下收益最明显
镜像源 + 并发 + 缓存三者必须联动生效
只调并发数、不换源,等于给堵车路口多开几条道;只换源、不清缓存,相当于导航还记着老路线。
- 全局换阿里云源:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效:
composer config -g repo.packagist输出应为完整 URL,不是null或空值 - 设完并发立即验证:
composer config --global http-max-concurrent-downloads 10 - 执行前先清缓存:
composer clear-cache,再跑composer install --no-dev --optimize-autoloader --prefer-dist
真正容易被忽略的是:这些优化不是“加了就快”,而是环环相扣——比如开了 --classmap-authoritative 却没清掉 autoload-dev 里的 PSR-4 映射,测试类照样进 classmap;又比如用了 --optimize-autoloader 却没配 opcache.revalidate_freq=0,每次请求都在重新校验 autoload_classmap.php 时间戳。



















