composer怎么使用腾讯云镜像_composer配置腾讯镜像源教程

推荐用 composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ 全局配置镜像源，务必带尾部斜杠；需检查并清除代理设置，勿禁用 https 校验。

composer config 命令改全局源，别直接改 config.json

改镜像源最稳妥的方式是用 composer config 命令，不是手动编辑 composer.json 或 config.json。手动改容易漏掉用户级配置位置，或被后续 composer update 覆盖。

• composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ —— 全局生效（推荐），影响所有项目
• composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/ —— 仅当前项目，不加 -g
• 执行后可在 ~/.composer/config.json（linux/macos）或 %APPDATA%Composerconfig.json（windows）里验证是否写入 repo.packagist 字段

腾讯云镜像地址必须带尾部斜杠，否则会 404

腾讯云镜像的正确地址是 https://mirrors.cloud.tencent.com/composer/，结尾的 / 缺不得。少它一个字符，composer install 时会卡在“Resolving packages…”然后报 Connection refused 或 404 Not Found —— 实际是重定向失败，nginx 拒绝了无尾缀的路径。

• 错的：https://mirrors.cloud.tencent.com/composer（无斜杠）
• 对的：https://mirrors.cloud.tencent.com/composer/（有斜杠）
• 可以用 curl -I https://mirrors.cloud.tencent.com/composer/ 看返回是否为 200 OK

国内网络下仍提示 “Could not fetch”，检查是否被 proxy 干扰

即使换了腾讯镜像，某些环境仍会因残留代理设置导致请求发到国外源。常见于公司网络、Clash/Shadowrocket 全局代理未关闭、或本地 http_proxy 环境变量未清空。

• 运行 env | grep -i proxy（Linux/macOS）或 set proxy（Windows cmd）确认无 http_proxy/https_proxy
• 临时清除：unset http_proxy https_proxy（Linux/macOS）或 set http_proxy=（Windows）
• Composer 自身也支持 composer config -g -u http-proxy 清除代理配置
• 如果用了 composer create-project 卡住，大概率是代理没关干净

verify-peer=false 不要轻易开，腾讯镜像本身支持 HTTPS 验证

有些教程教人加 "secure-http": false 或设 verify-peer=false 来绕过证书错误，但腾讯云镜像用的是有效 TLS 证书，根本不需要关校验。开了反而让 Composer 降级走 HTTP，可能被中间人劫持，或在新版 Composer（2.5+）中直接报错拒绝加载。

• 腾讯镜像地址是 HTTPS，且证书由 TrustAsia 签发，主流系统和 Openssl 版本都信任
• 若提示 SSL certificate problem，优先查系统 CA 证书是否过期（如 Alpine 容器缺 ca-certificates 包）
• 不要碰 composer config -g secure-http false，这是退化方案，不是解决镜像问题的正路

镜像配置本身很简单，真正耗时间的往往是网络层干扰和路径细节：斜杠、代理、证书链、配置作用域——这些地方一错，composer install 就会静默卡住或报模糊错误。