Composer 不支持多镜像源同时启用或自动故障转移，repo.packagist.org 仅接受单个 URL 字符串，后设值会覆盖前值；备用方案需依赖外部脚本捕获错误并手动切换镜像。
Composer 不支持“多个镜像源同时启用”或“自动故障转移式备用地址”——它每次只用一个 repositories 配置，且默认不带重试逻辑。
为什么 composer config repo.packagist.org 只能设一个 URL
Composer 的 repo.packagist.org 是全局仓库配置项，底层对应 Packagist 官方源的镜像地址。它本质是覆盖 https://packagist.org 的单一替换，不是负载均衡列表。你写两个 URL，后写的会直接覆盖前一个。
- 常见错误现象：
composer config -g repo.packagist.org https://mirrors.aliyun.com/composer/ https://packagist.phpcomposer.com—— 第二个 URL 不生效，命令还可能报错 - 使用场景：国内用户想防止单镜像宕机导致
composer install卡死 - 参数差异：
composer config -g repo.packagist.org接的是单个字符串，不是数组或 JSON 列表
真正可行的“备用镜像”方案：用 composer global require 装切换工具
官方不提供 fallback，但社区有轻量方案：通过 hirak/prestissimo（已停止维护）或更现代的 composer-plugin-mirror 不现实；实际最稳的方式是手动切换 + 脚本兜底。
- 推荐做法：全局安装
composer-alias或直接用 shell 函数封装常用镜像切换 - 实操建议：在 shell 配置里加这几个函数（以 zsh/bash 为例）：
alias composer-alipay='composer config -g repo.packagist.org https://packagist.phpcomposer.com' alias composer-aliyun='composer config -g repo.packagist.org https://mirrors.aliyun.com/composer/' alias composer-tencent='composer config -g repo.packagist.org https://mirrors.cloud.tencent.com/composer/'
- 性能影响：切换本身毫秒级，但每次换源后首次
composer update会清本地缓存，略慢几秒 - 兼容性：所有 Composer 2.x 版本都支持，无需改
composer.json
想自动 fallback？只能靠 wrapper 脚本捕获错误再重试
Composer 命令失败时退出码是非 0，你可以用 shell 捕获它，失败后换源重跑一次。这不是 Composer 内置能力，而是外部控制流。
- 容易踩的坑：别在
composer.json里硬编码多个repositories——那只会让 Packagist 官方源失效，且 Composer 会报Package operations: 0 installs, 0 updates, 0 removals这类诡异提示 - 实操建议：写个简单 wrapper（保存为
~/bin/ci并 chmod +x）：
#!/bin/sh composer install "$@" || (echo "First try failed; switching to Tencent mirror..." && \ composer config -g repo.packagist.org https://mirrors.cloud.tencent.com/composer/ && \ composer install "$@")
- 注意点：重试前必须确保上一个
composer config成功执行，否则 fallback 无意义 - 适用场景：CI/CD 流水线或批量部署时防止单点网络抖动
镜像切换不是“配一次就永远高可用”，每次换源后第一次运行会重建元数据缓存，而且不同镜像同步延迟可能达 5–15 分钟——如果你刚发布了一个包，别指望立刻在所有镜像里都能 require 到。
