如何将Composer内部VCS依赖配置拆分至独立文件？

1. 确认Composer版本要求 #

repositories-file 是Composer 2.2及以上版本才支持的特性，先检查当前版本：

composer --version

如果版本低于2.2，先升级Composer：

composer self-update

2. 编写独立仓库配置文件 #

• 在 composer.json 同级目录创建独立文件，比如命名为 composer.repos.json
• 文件内容直接是仓库配置数组，无需额外包裹结构，示例：

[
    {
        "type": "vcs",
        "url": "git@gitlab.com:your-team/package-a.git"
    },
    {
        "type": "vcs",
        "url": "git@gitlab.com:your-team/package-b.git"
    }
]

3. 在composer.json中关联独立文件 #

在 composer.json 的 config 段添加路径配置，路径相对于当前 composer.json：

{
    "config": {
        "repositories-file": "./composer.repos.json"
    },
    "repositories": [
        {
            "type": "composer",
            "url": "https://your-repman-domain.com"
        }
    ]
}

4. 确保内部依赖优先拉取（关键） #

Composer按仓库配置顺序查找依赖，要避免Repman拦截内部包，有两种实用方式：

方式一：在Repman仓库中排除内部包 #

在Repman的仓库配置里添加 exclude 选项，指定内部包的命名空间或前缀，让Composer跳过Repman直接查找VCS仓库：

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://your-repman-domain.com",
            "exclude": ["your-team/*", "internal-namespace/*"]
        }
    ]
}

方式二：调整仓库加载顺序 #

如果需要严格控制查找顺序，可将少量核心内部VCS仓库放在 composer.json 的 repositories 数组最前面，其余放在独立文件中——Composer会优先加载 composer.json 内的仓库，再加载独立文件的配置。

5. 清除缓存并验证 #

• 清除Composer缓存，避免旧配置干扰：

composer clear-cache

• 测试拉取内部依赖，查看来源是否正确：

composer show -v your-team/package-a

输出中会显示依赖的仓库地址，确认是GitLab地址而非Repman。

内容的提问来源于stack exchange，提问作者farmaper1561