Composer：如何为存在依赖层级的内部GitLab项目定义仓库？

核心问题在于Composer不会自动递归加载依赖包的repositories配置——也就是说，p2里定义的p3仓库地址，p1是看不到的。另外你配置里的gitlab-token域名也不对，你用的是本地GitLab实例（git.local.dev），但token却指向了gitlab.com，这也可能导致权限验证失败。

下面是几种可行的解决方案，按推荐程度排序：

方案1：使用本地GitLab的Composer仓库镜像（最优雅） #

如果你的本地GitLab实例支持Packages功能（GitLab CE/EE都支持），可以把p2、p3都发布到GitLab的私有Composer仓库里。这样只需要在p1的composer.json里添加一次GitLab镜像地址，所有内部依赖都能自动识别：

{
  "name": "my-group/p1",
  ...
  "minimum-stability": "dev",
  "prefer-stable": true,
  "repositories": [
    {
      "type": "composer",
      "url": "https://git.local.dev/api/v4/group/my-group/-/packages/composer/"
    }
  ],
  "config": {
    "gitlab-token": {
      "git.local.dev": "my-token"
    }
  },
  "require": {
    "my-group/p2": "dev-develop"
  }
}

这样p1安装时会从GitLab镜像拉取p2，而p2的依赖p3也会自动从同一个镜像获取，不需要每个项目单独配置VCS仓库。

方案2：在p1中显式添加所有依赖的仓库地址 #

如果暂时不想用镜像仓库，可以直接在p1的composer.json里同时添加p2和p3的VCS仓库：

{
  "name": "my-group/p1",
  ...
  "minimum-stability": "dev",
  "prefer-stable": true,
  "repositories": [
    {
      "type": "vcs",
      "url": "ssh://git@git.local.dev/my-group/p2.git"
    },
    {
      "type": "vcs",
      "url": "ssh://git@git.local.dev/my-group/p3.git"
    }
  ],
  "config": {
    "gitlab-token": {
      "git.local.dev": "my-token"
    }
  },
  "require": {
    "my-group/p2": "dev-develop"
  }
}

这种方式简单直接，但如果依赖链很长（比如还有p4、p5），就会导致repositories配置越来越臃肿。

方案3：全局配置本地GitLab仓库 #

你也可以把本地GitLab的仓库配置到全局的Composer配置文件中（~/.composer/config.json或者~/.config/composer/config.json），这样所有本地项目都能自动识别内部依赖：

{
  "repositories": [
    {
      "type": "composer",
      "url": "https://git.local.dev/api/v4/group/my-group/-/packages/composer/"
    }
  ],
  "config": {
    "gitlab-token": {
      "git.local.dev": "my-token"
    }
  }
}

之后p1的composer.json就可以简化，不需要再单独写repositories和config里的token了：

{
  "name": "my-group/p1",
  ...
  "minimum-stability": "dev",
  "prefer-stable": true,
  "require": {
    "my-group/p2": "dev-develop"
  }
}

关键注意点 #

• 一定要把gitlab-token的域名从gitlab.com改成你的本地实例域名git.local.dev，否则Composer会把token发送到公共GitLab，而不是你的本地服务，导致权限验证失败。
• 如果用SSH地址的VCS仓库，确保你的本地SSH密钥已经添加到GitLab账户中，避免出现拉取代码时的权限问题。

内容的提问来源于stack exchange，提问作者Antonín Slejška