在 Composer 中配置多个 repositories 时，优先级由 composer.json 中的声明顺序决定，越靠前优先级越高。Composer 会依次查找仓库，一旦找到匹配包即停止搜索，因此私有仓库应置于默认 Packagist 前以实现覆盖。可通过 "packagist.org": false 禁用默认仓库，仅使用私有源。建议将内部镜像或 VCS 仓库排前，保留公共仓库在后，避免同名同版本包冲突，确保依赖解析清晰可控。
在 Composer 中配置多个 repositories 并设置优先级，主要是通过在 composer.json 文件中按顺序声明仓库来实现的。Composer 会按照你在文件中定义的顺序依次查找包，先定义的仓库具有更高的优先级。
1. 配置多个 repositories
你可以在 composer.json 的 repositories 字段中添加多个自定义仓库，支持的类型包括 composer（私有镜像）、vcs（版本控制系统）、package 等。
示例：
{
"repositories": [
{
"type": "composer",
"url": "https://asset-packagist.org"
},
{
"type": "vcs",
"url": "https://github.com/your-company/your-private-repo.git"
},
{
"type": "package",
"package": {
"name": "vendor/custom-package",
"version": "1.0.0",
"dist": {
"url": "https://example.com/custom-package-1.0.0.zip",
"type": "zip"
}
}
}
],
"require": {
"vendor/custom-package": "^1.0"
}
}
2. 仓库优先级规则
Composer 查找依赖时，会从上到下遍历 repositories 列表。一旦在某个仓库中找到匹配的包版本，就不会继续查找后面的仓库。
这意味着：
- 排在前面的仓库优先级更高
- 如果你希望私有包覆盖 Packagist 上的同名包，应将私有仓库放在默认仓库之前
- 内置的 Packagist 是默认仓库，除非显式禁用，否则始终存在
3. 禁用默认 Packagist 仓库（可选）
如果你只想使用私有仓库，可以显式禁用默认的 Packagist：
{
"repositories": [
{
"packagist.org": false
},
{
"type": "composer",
"url": "https://your-private-composer-mirror.com"
}
]
}
这样 Composer 就不会去 packagist.org 查找包，仅使用你指定的仓库。
4. 实际应用建议
常见场景是企业内使用私有 VCS 或私有 Composer 镜像，同时保留对公共包的访问：
- 把内部镜像或 VCS 放在前面，确保私有包优先被加载
- 保持 packagist.org 在后面，用于下载通用开源组件
- 避免在多个仓库中发布相同名称和版本的包，防止混淆
