如何将公司内部的GitLab/Gitee作为Composer的私有仓库？（配置指南）

将GitLab/Gitee配置为Composer私有仓库的核心是安全自动拉取包，需满足：项目含合规composer.json、配置vcs型repositories、通过PAT或SSH设置免密认证，并使用语义化标签管理版本。

把公司内部的 GitLab 或 Gitee 配置为 Composer 的私有仓库，核心是让 composer install 和 composer require 能安全、自动地拉取私有项目（比如内部公共组件、SDK、基础服务包等）。关键不在“能不能”，而在“怎么配得稳、用得顺、管得住”。

一、确保私有仓库项目已正确发布为 Composer 包

你的私有项目（如 company/utils）必须满足 Composer 的基本规范：

• 根目录下有 composer.json，且含合法 name（格式为 vendor/name，如 acme/utils），version 或通过 Git tag 管理版本（推荐用 v1.0.0 这类语义化标签）
• 代码可公开克隆（HTTP/HTTPS 或 SSH），但访问需认证（后面会配置凭证）
• 建议开启 GitLab/Gitee 的 Package Registry（非必需，但能统一管理 .phar/.zip 包；Composer 默认走源码方式，所以先不强依赖它）

二、在项目中声明私有仓库源（v2 推荐方式）

从 Composer 2.0+ 开始，推荐使用 repositories + type: vcs 方式，无需改全局配置，更清晰可控。

在你业务项目的 composer.json 中添加：

"repositories": [
  {
    "type": "vcs",
    "url": "https://gitlab.example.com/acme/utils.git"
  },
  {
    "type": "vcs",
    "url": "https://gitee.com/acme/sdk.git"
  }
]

登录后复制

✅ 这样 Composer 就知道去哪找 acme/utils 的源码了。但注意：GitLab/Gitee 的私有仓库需要认证，否则会报 401 或 Cloning into ... Permission denied。

标签： js git json composer ai gitlab gitee