Composer 支持为同一个包配置多个备选的私有仓库，当第一个仓库无法获取该包时，会自动尝试下一个。实现方式是通过在 composer.json 的 repositories 字段中定义多个仓库，并将它们按优先级顺序排列。

使用多个私有仓库作为备选源

你可以在 composer.json 中列出多个类型为 composer 的私有仓库，Composer 会从上到下依次查找包：

示例配置：

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://packages.example.com"
        },
        {
            "type": "composer",
            "url": "https://backup-packages.example.com"
        },
        {
            "type": "composer",
            "url": "https://internal.repo.company.net"
        }
    ],
    "require": {
        "your-vendor/your-package": "^1.0"
    }
}

Composer 查找包的流程如下：

神笔马良 - AI让剧本一键成片。

• 先去 https://packages.example.com 查找 your-vendor/your-package
• 如果找不到或网络异常，则尝试 https://backup-packages.example.com
• 仍失败则继续尝试第三个

注意事项与最佳实践

虽然可以配置多个仓库，但需注意以下几点以避免问题：

• 仓库顺序很重要，靠前的优先级更高
• 确保每个仓库都支持你所需版本的包，避免因元数据不一致导致安装失败
• 私有仓库通常需要认证，在 auth.json 中配置对应凭证：

{
    "http-basic": {
        "packages.example.com": {
            "username": "your-username",
            "password": "your-token"
        },
        "backup-packages.example.com": {
            "username": "backup-user",
            "password": "backup-token"
        }
    }
}

• 若多个仓库包含同名包的不同版本，Composer 会选择能满足依赖约束的最高优先级仓库中的版本
• 建议对关键包做镜像同步，而不是完全依赖链式回退，以防意外行为

使用场景举例

这种配置适合以下情况：

• 主私有仓库临时不可用，启用备份源保证 CI/CD 流程不中断
• 跨地域部署，就近访问本地镜像仓库提升下载速度
• 迁移仓库期间，双写阶段保持服务连续性