当前最稳的阿里云 composer 镜像地址是 https://mirrors.aliyun.com/composer/;旧 http 地址被拒,phpcomposer.com 已停服;ecs 用户应优先使用内网地址 http://mirrors.cloud.aliyuncs.com/composer/。

阿里云镜像地址现在用哪个?别再输错 URL
2026 年当前最稳、全量同步、HTTPS 可靠的地址只有一个:https://mirrors.aliyun.com/composer/。旧的 http:// 地址(如 http://mirrors.aliyuncs.com/composer/)在 Composer 2.x+ 默认被拒绝,会报 Invalid repository type;而 phpcomposer.com 已于 2025 年底彻底停服,配置它会直接触发 404 Not Found 错误。
- ✅ 正确写法:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/(末尾斜杠/不可省,缺了部分版本会 404) - ❌ 常见错误:把
repo.packagist误写成repos.packagist(Composer ≥2.0 已废弃该 key) - ⚠️ 注意:腾讯云镜像
https://mirrors.cloud.tencent.com/composer/公网不稳定,实测偶发 502 或超时,不建议跨云使用
全局配置后还是走 packagist.org?优先级和覆盖逻辑
Composer 的源配置按「项目级 → 用户级(-g)→ 全局默认」逐层合并,但项目里一旦显式写了 "repositories" 字段,就会完全跳过你配的全局镜像——这是最常被忽略的“镜像失效”原因。
- 检查是否被覆盖:
composer config -g repo.packagist应输出{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"};若为空或仍是官方地址,说明没生效 - 查项目级干扰:
grep -A3 '"repositories"' composer.json,如果看到硬编码的"packagist.org"或其他源,删掉或注释掉它 - 清缓存再试:
composer clear-cache,否则即使改了配置,install还可能沿用旧索引
ECS 用户必看:内网地址省流量又提速
如果你在阿里云 ECS 上跑 CI/CD 或部署 PHP 应用,用公网 HTTPS 镜像既慢又耗流量。VPC 和经典网络用户应切换为无 HTTPS 的内网地址,实测延迟压到 10ms 内,且零丢包。
- VPC 网络用户(推荐):
http://mirrors.cloud.aliyuncs.com/composer/ - 经典网络用户:
http://mirrors.aliyuncs.com/composer/ - 命令示例:
composer config -g repo.packagist composer http://mirrors.cloud.aliyuncs.com/composer/ - ⚠️ 注意:内网地址仅限阿里云内网访问,本地开发机或非阿里云服务器不能用
临时验证或调试:绕过所有配置直连镜像
当你怀疑镜像配置没生效,或者想快速验证某个包是否能从阿里源拉下来,可以用 -r 参数强制指定源——它会忽略项目和全局的所有 repositories 设置,只认这个 URL。
- 临时装包测试:
composer require --dev phpunit/phpunit:^9.6 -r https://mirrors.aliyun.com/composer/ -vvv -
-vvv会打印真实请求的域名,确认是否命中mirrors.aliyun.com - ⚠️ 注意:
composer create-project不支持-r,此时得先config -g临时设好,再执行
最容易漏掉的点是:项目 composer.json 里藏着 "repositories",它比全局配置更重;其次是内网用户还在用公网 HTTPS 地址,白白浪费带宽和时间。配完别凭感觉,composer config -g repo.packagist 和 composer -vvv require xxx 才是真凭据。











