如何将一个私有的GitHub/GitLab组织设置为Composer仓库源？（Group/Organization Repositories）

Composer 访问私有 GitHub/GitLab 仓库需组合配置：1. 配置 Git 认证（SSH 或 PAT）；2. 在 composer.json 中通过 vcs 类型 repositories 声明具体仓库地址并 require；3. 多包场景可选 Satis 或 Private Packagist；4. 私有包自身须规范 name、autoload 和 tag 发布。

要让 Composer 能从私有 GitHub 或 GitLab 组织（Group/Organization）下的仓库拉取包，核心不是“把整个组织设为源”，而是让 Composer 能安全、自动地访问组织内特定的私有仓库。这需要组合配置：认证机制 + 包定义方式 + 可选的自建包发现服务。

1. 配置 Git 认证凭证（必需）

Composer 通过 Git 协议克隆私有仓库，所以必须让系统级 Git 能无交互地认证。推荐用 SSH 密钥或个人访问令牌（PAT）：

• GitHub 推荐 SSH：生成 SSH 密钥并添加到 GitHub 账户；确保 git@github.com:org-name/repo-name.git 可手动 clone 成功；Composer 会自动复用系统 Git 的 SSH 配置。
• GitLab 或需 HTTPS + PAT：在 ~/.gitconfig 中配置凭证 helper，或使用 git config --global url."https://<font color="red">TOKEN</font>@gitlab.com/".insteadOf "https://gitlab.com/"（注意 TOKEN 要 URL 编码，且需 read_repository 权限）。

2. 在项目中声明私有包（直接引用）

不需要全局注册组织，只需在项目的 composer.json 中明确写明包名和仓库地址：

• 确保包的 name 字段符合规范，如 "myorg/my-package"（与 GitHub/GitLab 的 org-name/repo-name 对应）。
• 在 repositories 段添加类型为 vcs 的条目：
  "repositories": [{ "type": "vcs", "url": "https://gitlab.com/myorg/my-package.git" }]
• 然后在 require 中写 "myorg/my-package": "^1.0"，Composer 就会从该地址拉取。

3. 使用 Satis 或 Private Packagist（适合多包管理）

如果组织下有几十个私有包，每次手动加 repositories 很麻烦。这时可部署一个包发现服务：

标签： js git json composer github 编码 gitlab