如何在 Composer 中配置私有的 Git 仓库作为包来源（VCS repositories）？

Composer支持从私有Git仓库拉取包，需在composer.json中声明vcs类型仓库、配置认证（HTTPS用Token或凭据助手，SSH用密钥），并遵循name命名规范及dev-分支/tag版本约束。

Composer 支持直接从私有 Git 仓库拉取包，无需发布到 Packagist。关键在于正确声明仓库类型、URL 和版本约束，并确保认证可用。

在 composer.json 中声明私有 VCS 仓库

在项目的 composer.json 文件中，添加 repositories 字段，指定仓库类型为 vcs，并提供 Git 地址（支持 HTTPS 或 SSH）：

• HTTPS 示例（推荐配合凭证管理或 Personal Access Token 使用）：
  "url": "https://git.example.com/myorg/my-package.git"
• SSH 示例（需本地配置好 SSH key 并能免密访问）：
  "url": "git@git.example.com:myorg/my-package.git"

完整配置示例：

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://git.example.com/myorg/my-package.git"
    }
  ],
  "require": {
    "myorg/my-package": "dev-main"
  }
}

登录后复制

确保 Composer 能访问私有仓库

HTTPS 方式需解决认证问题：

• 使用 GitHub/GitLab 的 Personal Access Token：在 URL 中嵌入（不推荐长期使用）
  "https://TOKEN:x-oauth-basic@git.example.com/myorg/my-package.git"
• 更安全的做法是配置 Git 凭据助手（如 git config --global credential.helper store），让 Git 自动处理用户名密码或 token
• SSH 方式依赖系统级 SSH 配置，确保运行 composer install 的用户能执行 git clone git@git.example.com:... 成功

包的命名与版本识别规则

私有仓库中的 composer.json 必须定义 name（格式为 vendor/name），且不能与 Packagist 上已存在包名冲突。

标签： composer git仓库 js git json github access ai gitlab red asic