如何找到稳定好用的Composer镜像站,推荐珍藏版合集?
- 内容介绍
- 文章标签
- 相关推荐
本文共计788个文字,预计阅读时间需要4分钟。
当前可稳定使用的Composer全面镜像,仅剩阿里云、华为云、腾讯云和交大SJTUG这几家。
怎么确认你当前用的是哪个源
执行这条命令就能看到实际生效的配置:
composer config -g repo.packagist
输出应该是类似这样的 JSON:
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果输出为空、是 https://packagist.org,或者报错说 key not found,说明镜像根本没生效。常见原因有:
-
repo.packagist写成了repos.packagist(Composer ≥2.0 已废弃后者) - 项目根目录下
composer.json里硬写了"repositories"字段,会直接覆盖全局配置 - 缓存没清,
composer clear-cache必须跑一次
阿里云镜像:公网 vs 内网地址别混用
公网用户统一用这个地址,HTTPS 安全且全量同步:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
末尾的 / 不能省,缺了某些版本会 404。如果你在阿里云 ECS 上部署或跑 CI,优先切内网地址:
- VPC 网络:
http://mirrors.cloud.aliyuncs.com/composer/ - 经典网络:
http://mirrors.aliyuncs.com/composer/
注意:内网地址只能在阿里云内网访问,本地开发机配了也连不上,会卡住或超时。
其他可用镜像及实测表现
华为云和交大 SJTUG 镜像目前同步及时、无限速,适合对稳定性要求高的生产环境:
- 华为云:
https://mirrors.huaweicloud.com/repository/php/(注意路径是/repository/php/,不是/composer/) - 交大 SJTUG:
https://packagist.mirrors.sjtug.sjtu.edu.cn/(教育网访问极快,公网也稳)
腾讯云镜像虽然地址公开,但实测公网偶尔返回 502 Bad Gateway 或连接超时,不建议作为主力源;安畅网络(https://php.cnpkg.org/)近年更新频率下降,部分包索引延迟明显。
项目级配置被忽略?检查 composer.json 里的 repositories
很多人配完全局镜像,composer install 还是慢,就是因为项目里写了这个:
"repositories": [ {"type": "composer", "url": "https://packagist.org"} ]
只要 composer.json 里存在 "repositories" 字段,Composer 就会完全忽略你配的 repo.packagist,哪怕它只是个空数组。解决方法只有两个:
- 删掉或注释掉整个
"repositories"块 - 把里面的内容改成你要用的镜像地址,例如:
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
改完记得 composer clear-cache,否则旧缓存可能继续干扰安装行为。
本文共计788个文字,预计阅读时间需要4分钟。
当前可稳定使用的Composer全面镜像,仅剩阿里云、华为云、腾讯云和交大SJTUG这几家。
怎么确认你当前用的是哪个源
执行这条命令就能看到实际生效的配置:
composer config -g repo.packagist
输出应该是类似这样的 JSON:
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果输出为空、是 https://packagist.org,或者报错说 key not found,说明镜像根本没生效。常见原因有:
-
repo.packagist写成了repos.packagist(Composer ≥2.0 已废弃后者) - 项目根目录下
composer.json里硬写了"repositories"字段,会直接覆盖全局配置 - 缓存没清,
composer clear-cache必须跑一次
阿里云镜像:公网 vs 内网地址别混用
公网用户统一用这个地址,HTTPS 安全且全量同步:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
末尾的 / 不能省,缺了某些版本会 404。如果你在阿里云 ECS 上部署或跑 CI,优先切内网地址:
- VPC 网络:
http://mirrors.cloud.aliyuncs.com/composer/ - 经典网络:
http://mirrors.aliyuncs.com/composer/
注意:内网地址只能在阿里云内网访问,本地开发机配了也连不上,会卡住或超时。
其他可用镜像及实测表现
华为云和交大 SJTUG 镜像目前同步及时、无限速,适合对稳定性要求高的生产环境:
- 华为云:
https://mirrors.huaweicloud.com/repository/php/(注意路径是/repository/php/,不是/composer/) - 交大 SJTUG:
https://packagist.mirrors.sjtug.sjtu.edu.cn/(教育网访问极快,公网也稳)
腾讯云镜像虽然地址公开,但实测公网偶尔返回 502 Bad Gateway 或连接超时,不建议作为主力源;安畅网络(https://php.cnpkg.org/)近年更新频率下降,部分包索引延迟明显。
项目级配置被忽略?检查 composer.json 里的 repositories
很多人配完全局镜像,composer install 还是慢,就是因为项目里写了这个:
"repositories": [ {"type": "composer", "url": "https://packagist.org"} ]
只要 composer.json 里存在 "repositories" 字段,Composer 就会完全忽略你配的 repo.packagist,哪怕它只是个空数组。解决方法只有两个:
- 删掉或注释掉整个
"repositories"块 - 把里面的内容改成你要用的镜像地址,例如:
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
改完记得 composer clear-cache,否则旧缓存可能继续干扰安装行为。

