Composer配置腾讯云云之翼镜像的方法（操作指南）-composer-PHP中文网

腾讯云“云之翼”镜像不存在，官方镜像地址仅为 https://mirrors.cloud.tencent.com/composer/；配置需严格满足三要素：键名必须为 repo.packagist、type 必须显式写 composer、url 末尾必须带 /；验证以 composer config -g repo.packagist 输出完整 json 为准，且需执行 composer clear-cache。

composer配置腾讯云云之翼镜像的方法（操作指南）

腾讯云“云之翼”镜像并不存在——官方镜像地址只有 https://mirrors.cloud.tencent.com/composer/，所谓“云之翼”是误传或混淆名称。配错地址、键名或参数，composer config -g repo.packagist 命令会静默失败，install 仍连 packagist.org，且无任何报错提示。

执行 `composer config -g repo.packagist` 必须严格满足三要素

这条命令不是“试试看”，它只认固定格式，缺一不可：

repo.packagist 是唯一合法键名，写成 repos.packagist、repositories.packagist 或 repo.packagist.org 全部无效
composer 是必须显式写出的 type 值，漏掉就创建空仓库，不报错但不生效
URL 必须是 https://mirrors.cloud.tencent.com/composer/ ——末尾 / 少一个字符，Composer 2.2+ 起就会返回 Invalid repository type 或 404

验证是否真生效，别信 `composer diagnose`

composer diagnose 只检查基础环境，完全不读取你刚配的镜像，它永远显示 Repo packagist.org is default。真正有效的验证方式只有两个：

腾讯云跨账号资源迁移

腾讯云跨账号资源迁移工具，支持将账号A的VPC、CLB、NAT、CVM、安全组等资源迁移至账号B，通过CCN云联网实现跨账号网络互通，提供自动扫描、配置生成、Terraform部署功能。

下载

运行 composer config -g repo.packagist，输出必须是完整 JSON：{"type":"composer","url":"https://mirrors.cloud.tencent.com/composer/"}
加 -vvv 看真实请求：composer show laravel/framework --no-ansi -vvv 2>&1 | grep "mirrors.cloud.tencent.com"，没出现这个域名就等于没走镜像

项目级配置会直接覆盖全局，不是“叠加”而是“替换”

只要项目根目录的 composer.json 里有 repositories 字段，无论内容是否包含 packagist.org，全局镜像都会被无视。常见陷阱包括：

脚手架模板自带 "repositories": {"packagist.org": false} —— 这等于禁用了默认源，又没给替代源，结果是 Could not find package
执行 composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/（不加 -g）会清空整个 repositories 对象，原有私有源（如 Nexus、Satis）全丢
想保留私有源又加镜像？必须手动编辑 composer.json，在 repositories 里加一条 "packagist": {"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}，同时确保根节点有 "packagist.org": false

`composer clear-cache` 不是可选项，是必做动作

换源后不清理缓存，Composer 会继续用旧的 p2/ 索引和 packages.json，行为与新配置完全不一致。尤其要注意：

composer clear-cache 必须执行，否则 install 仍可能卡在 0 B/s
已有 composer.lock 文件时，切换镜像后 install 必然报 hash 不匹配——因为 lock 里硬编码了从 packagist.org 下载的 dist URL 和校验值，镜像站路径结构不同，无法复用
CI/CD 中建议加 --no-cache 或每次构建前跑 composer clear-cache，避免缓存污染导致行为漂移

最常被忽略的点：镜像地址末尾那个 /，不是风格问题，是协议路径拼接的硬性要求；而 composer config -g repo.packagist 的输出 JSON，才是唯一可信的生效证据——其他一切提示都可能是假象。