可通过配置composer.json中的repositories字段引入多个私有仓库，支持composer、vcs和package类型，按顺序查找包；需通过SSH密钥或个人访问令牌等方式完成认证，并合理管理仓库顺序与命名规范以避免冲突。
在使用 Composer 管理 PHP 项目依赖时，如果需要引入多个私有仓库中的包（比如 GitLab、GitHub、Satis 或私有 Packagist 实例），可以通过在项目的 composer.json 文件中配置多个仓库来实现。Composer 支持多种类型的私有仓库，并能按顺序查找包。
1. 配置多个不同类型的私有仓库
Composer 的 repositories 字段允许你定义多个仓库源，支持的类型包括：
- composer：指向一个遵循 Composer 协议的仓库（如 Satis、私有 Packagist）
- vcs：通过 Git、Mercurial 等版本控制系统拉取代码（如 GitLab、GitHub 私有库）
- package：直接定义某个包的下载地址（较少用）
你可以在 composer.json 中这样配置：
{
"repositories": [
{
"type": "composer",
"url": "https://private-packagist.example.com"
},
{
"type": "vcs",
"url": "git@gitlab.company.com:team/private-lib.git"
},
{
"type": "vcs",
"url": "https://github.com/company/internal-sdk.git"
}
],
"require": {
"company/private-lib": "^1.0",
"company/internal-sdk": "^2.0"
}
}
Composer 会从上到下查找包，一旦在某个仓库中找到所需包，就不再继续搜索后面的仓库。
2. 认证访问私有仓库
访问私有仓库通常需要身份验证，根据仓库类型不同，认证方式也不同：
- VCS 类型（Git）：推荐使用 SSH 密钥。确保你的服务器或本地环境已配置好 SSH 公钥，并添加到 Git 服务（如 GitLab、GitHub）中。也可以使用 HTTPS + 个人访问令牌（PAT）方式：
"repositories": [
{
"type": "vcs",
"url": "https://oauth2:TOKEN@gitlab.company.com/team/private-repo.git"
}
]
- Composer 类型（私有 Composer 仓库）：需在 auth.json 文件中配置认证信息：
{
"http-basic": {
"private-packagist.example.com": {
"username": "your-username",
"password": "your-api-token"
}
}
}
该文件应放在项目根目录或 Composer 的全局配置目录（如 ~/.config/composer/auth.json），避免提交到版本控制。
3. 注意事项与最佳实践
- 仓库顺序很重要：把最常用的或包含核心包的仓库放前面，提升解析效率
- 避免重复定义：Composer 默认会从 packagist.org 拉取公开包，除非你显式禁用它（"packagist.org": false）
- 私有包命名建议使用组织/项目格式（如 company/utils），避免与公开包冲突
- 使用 composer show -s 可查看当前项目配置的仓库列表
- 调试仓库问题可用 composer install -vvv 查看详细请求过程
