Composer 的 "gitlab-domains" 配置用于识别私有 GitLab 实例域名，如 git.yourcompany.com；配置后 Composer 能自动启用 GitLab 通信机制、使用 OAuth 认证、正确解析仓库路径并调用 API；需在全局或项目 composer.json 中添加域名列表，否则可能遭遇“Repository not found”或认证失败。
Composer 的 "gitlab-domains" 配置项用于指定项目中使用的私有 GitLab 实例的域名列表。当你在使用 Composer 安装或更新依赖时，如果某个包托管在非官方 GitLab（即 gitlab.com 以外的自建 GitLab 服务）上，Composer 需要知道这些域名属于 GitLab 类型的服务，以便正确处理仓库克隆、OAuth 认证和 API 请求。
作用说明
默认情况下，Composer 只识别 gitlab.com 为官方 GitLab 服务。如果你的企业或团队使用的是内部部署的 GitLab（如 git.yourcompany.com），就需要通过 gitlab-domains 明确告诉 Composer 这些域名也属于 GitLab 环境。
配置后，Composer 会：
- 自动启用 GitLab 的专用通信机制
- 使用 GitLab OAuth 流程获取访问令牌
- 正确解析仓库路径并生成克隆链接
- 调用对应的 GitLab API 获取版本信息
配置方法
可以在全局 config 或项目级 composer.json 中添加：
{
"config": {
"gitlab-domains": ["git.yourcompany.com", "gitlab.internal"]
}
}
这样 Composer 就能识别这些域名下的私有 GitLab 项目，并支持以 SSH 或 HTTPS 方式拉取代码，同时自动处理个人访问令牌（PAT）认证。
典型使用场景
常见于企业内网环境：
- 公司搭建了私有的 GitLab CE/EE 服务
- 多个系统共用不同 GitLab 子域名
- 需要 CI/CD 流水线中自动拉取私有组件
基本上就这些，不复杂但容易忽略。没配的话，可能会遇到“Repository not found”或认证失败的问题。只要把自建 GitLab 的域名加进去，Composer 就能正常工作了。
