如何配置Composer备用镜像源以实现多源容灾配置？

本文共计1082个文字，预计阅读时间需要5分钟。

Composer 没有内置的备用，需要自行配置或安装相关依赖。

为什么 repositories 不能当镜像 fallback 用

Composer 的 repositories 是静态元数据合并逻辑，不是运行时请求代理。它按数组顺序读取各源的 packages.json，合并后生成一张包索引表；下载时只从**第一个提供该包完整版本信息的源**拉取 dist 文件，不会在安装失败后尝试下一个源。

常见错误现象：

• composer install 卡在某个私有源超时，不自动切到阿里云镜像
• 把 https://mirrors.aliyun.com/composer/ 和 https://packagist.org 同时写进 repositories，结果官方包仍走慢速源（因元数据合并顺序导致 dist URL 被覆盖）
• 私有源临时不可达，composer update 直接报错退出，而非降级使用 packagist.org

根本原因：Composer 不做 HTTP 层重试或源切换，它只管“谁先声明了这个包”，不管“这个源现在能不能用”。

真·容灾：用脚本控制镜像源切换

真实可用的主备逻辑必须由 shell 或 PHP 脚本驱动，在执行 composer 命令前动态设置当前有效源。