更换国内镜像源可显著提升Composer安装速度,推荐使用阿里云或Laravel China镜像;优先使用composer install而非update以避免重复解析依赖;启用全局缓存与并行下载;合理使用--no-scripts和--classmap-authoritative等选项优化加载;升级至Composer 2.x版本获得性能提升。

使用 Composer 安装或更新依赖时速度慢,是 PHP 开发中常见的痛点。网络延迟、默认源在国外、包解析复杂等因素都会导致卡顿甚至超时。以下是针对 composer install 与 composer update 速度慢问题的实用优化方案汇总,帮助你显著提升执行效率。
更换为国内镜像源(最有效)
Composer 默认连接 packagist.org,位于海外。切换为国内镜像可极大提升下载速度。
-
阿里云镜像(推荐):
composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/ -
中国全量镜像(Laravel China):
composer config -g repos.packagist composer https://packagist.phpcomposer.com - 若需临时使用,可在项目目录下运行命令去掉
-g参数,仅对当前项目生效。
启用 Composer 全局缓存与并行下载
合理配置缓存机制和并发请求,减少重复下载和等待时间。
-
确保缓存目录可写,Composer 会缓存已下载的包:
composer config -g cache-dir /path/to/cache -
开启并行下载(Composer 2+ 默认开启),加快多包安装:
无需额外设置,若关闭了可通过配置启用。 - 清理无用缓存释放空间:
composer clear-cache
避免频繁执行 composer update
composer update 会重新解析所有依赖版本,耗时较长。日常开发应尽量避免。
- 生产环境或 CI 流程中使用 composer install,它直接读取
composer.lock文件,安装确定版本,速度快且稳定。 - 只有在需要升级依赖版本时才运行 composer update。
- 可指定包名来缩小更新范围:
composer update vendor/package
优化自动加载与脚本执行
某些项目在安装后执行大量脚本或生成冗长的 autoload 文件,拖慢整体速度。
- 跳过脚本执行(如部署时):
composer install --no-scripts - 不生成优化的自动加载文件(开发阶段可忽略):
composer install --classmap-authoritative 只在必要时使用。 - 使用
optimize-autoloader在生产环境提升运行效率,但会增加安装时间,建议权衡使用场景。
升级到 Composer 2.x
Composer 2 相比 1.x 版本有显著性能提升,包括更快的依赖解析和并行处理能力。
- 检查当前版本:
composer --version - 升级命令:
composer self-update - 确认使用的是最新稳定版以获得最佳性能。
基本上就这些。通过换源、合理使用命令、关闭非必要操作和保持工具更新,可以彻底解决 Composer 安装慢的问题。关键在于区分 install 和 update 的使用场景,并坚持使用国内镜像。不复杂但容易忽略。










