腾讯云Composer镜像已下线,需切换至阿里云或华为云等可用镜像源,并清缓存、验证配置生效;项目级repositories会覆盖全局设置,必须一并清理。

腾讯云 Composer 镜像已停止服务,自 2024 年 10 月 1 日起正式下线,https://mirrors.cloud.tencent.com/composer/ 返回 404,所有配置都会失效。
为什么 composer config -g repo.packagist 不生效?
这是最常遇到的错误现象:执行命令后 composer install 仍走官方源,或报 Connection refused / SSL certificate problem —— 实际不是配置没写对,而是镜像本身已不可用。腾讯云未提供迁移路径或替代地址,直接关停。
-
composer config -g repo.packagist写入的是全局配置,但只在镜像服务可用时才起作用 - 部分旧教程残留的
https://packagist.phpcomposer.com(早已停运)或腾讯云地址,现在会卡在 DNS 解析或 404 - PHP 8.2+ + Composer 2.7+ 默认启用 HTTPS 强校验,遇到无效证书或重定向会直接失败,不会静默回退
当前可用的国内替代镜像有哪些?
推荐优先使用阿里云或华为云镜像,二者稳定、同步及时、支持 HTTPS 和 Composer 2.x 协议。不建议尝试“修复”腾讯云配置,而是切换到仍在维护的源。
腾讯云跨账号资源迁移工具,支持将账号A的VPC、CLB、NAT、CVM、安全组等资源迁移至账号B,通过CCN云联网实现跨账号网络互通,提供自动扫描、配置生成、Terraform部署功能。
- 阿里云:
https://mirrors.aliyun.com/composer/(需确认未被企业网络策略拦截) - 华为云:
https://repo.huaweicloud.com/php/(注意路径是/php/,不是/composer/) - 清华大学源已改为反向代理模式,仅限教育网内访问稳定,公网用户可能遇到 503
- 切勿使用 GitHub 上未经验证的第三方镜像仓库,存在包篡改风险
如何安全切换镜像并验证?
执行以下三步,避免残留配置干扰:
- 先清除旧镜像:
composer config -g --unset repos.packagist - 设置新镜像(以阿里云为例):
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效:
composer config -g repo.packagist应输出{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"};再运行composer show -p | head -3观察请求 URL 是否含aliyun.com
如果项目级有 composer.json 中硬编码了 repositories,需手动删掉对应块,否则会覆盖全局配置。
镜像切换不是“一劳永逸”的操作——国内源每年都有关停或策略变更,建议在 CI 流程中加入 composer diag 检查源连通性,而不是依赖某一个固定地址。

















