composer安装慢主因是dns污染或连接超时导致请求未发出,需验证镜像是否生效并正确配置阿里云或清华镜像;create-project默认忽略全局镜像,需用--repository-url参数或删项目composer.json中的repositories字段;update卡住可能因证书、代理或git依赖,镜像仅加速packagist公开包。

Composer install 速度慢到卡住?先确认是不是镜像没生效
国内直接走官方源 packagist.org,99% 的慢都是 DNS 污染或连接超时导致的。不是你网络差,是请求根本没发出去——Composer 默认用 HTTPS 访问国外源,中间可能被重置或丢包。
验证是否生效:运行 composer config -g repo.packagist,如果输出是 {"type": "composer", "url": "https://packagist.org"},说明镜像根本没设上。
- 全局设置阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 清华镜像(部分包同步略滞后):
composer config -g repo.packagist composer https://packagist.phpcomposer.com(已停用)或改用https://mirrors.tuna.tsinghua.edu.cn/composer/ - 设完立刻验证:
composer config -g repo.packagist,确保返回的是你刚配的 URL
为什么 composer create-project 还是走官网?
这个命令默认忽略全局镜像配置,它会读取目标项目的 composer.json 中的 repositories 字段,优先级高于全局设置。
常见场景:用 laravel/laravel 或 thinkphp/think 脚手架初始化时,模板里自带了官方源声明。
- 临时绕过项目配置,强制走镜像:
composer create-project --repository-url=https://mirrors.aliyun.com/composer/ laravel/laravel - 更稳妥的做法:初始化后进项目目录,删掉
composer.json里的"repositories"块,再跑composer install - 注意:有些私有包依赖必须保留特定源,删前先看清楚字段内容
composer update 卡在 “Loading composer repositories”?可能是证书或代理问题
镜像地址用了 HTTPS,但某些企业网络或老旧 PHP 环境不信任国产 CA,或者开了系统代理却没配 Composer 的 http-proxy。
错误典型表现:Failed to decode response: zlib_decode(): data error 或直接 hang 住 5 分钟后报 Connection timed out。
- 关掉代理再试:
composer config -g --unset http-proxy、composer config -g --unset https-proxy - 若必须走代理,确保格式正确:
composer config -g http-proxy http://127.0.0.1:8888(不要带https://) - 跳过 SSL 验证(仅临时调试):
export COMPOSER_DISABLE_TLS=1,但别长期开着,有安全风险
镜像不是万能的,这些情况它帮不上忙
镜像只加速 packagist.org 上公开包的元数据和 ZIP 下载。一旦涉及 GitHub、GitLab 或私有 Git 仓库,Composer 仍会直连原地址。
比如 "monolog/monolog": "dev-main as 2.10.0" 这种从 GitHub 分支安装,或 "my/private-package": "dev-master" 指向私仓,镜像完全不参与。
- Git 类依赖慢,优先换为 dist 包:
composer config -g prefer-dist true - 私有包必须走 Git,可考虑在内网搭
toran-proxy或satis,镜像无法替代这类服务 - PHP 扩展缺失(如
ext-zip)也会让install卡在解压环节,和镜像无关,得查php -m
镜像只是管道,不是魔法。真慢的时候,先分清是“找包慢”还是“下包慢”还是“装包慢”,再决定该调镜像、换网络、还是修环境。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











