配置私有GitLab包需在composer.json中添加vcs仓库地址，使用Personal Access Token或SSH密钥认证，确保私有包含正确composer.json文件，最后运行composer install即可安装。
在使用 Composer 管理 PHP 项目依赖时，有时需要引入存放在私有 GitLab CE/EE 仓库中的包。由于这些仓库不对外公开，Composer 默认无法访问，必须进行额外配置才能正常加载。以下是完整的实现方法。
1. 配置 composer.json 的 repositories 和 vcs 信息
首先，在项目的 composer.json 文件中添加对私有 GitLab 仓库的引用。使用 type: "vcs" 告诉 Composer 这是一个版本控制系统仓库。
{
"repositories": [
{
"type": "vcs",
"url": "https://gitlab.example.com/username/private-package.git"
}
],
"require": {
"vendor/private-package": "dev-main"
}
}
注意替换 URL 为你的实际 GitLab 项目地址。分支名如 dev-main 或 dev-master 根据实际情况调整。
2. 提供 GitLab 访问凭证
Composer 在拉取私有仓库时需要身份验证。GitLab 支持以下几种认证方式：
-
Personal Access Token（推荐）：在 GitLab 用户设置中生成一个具有
read_repository权限的 Token。 - SSH Key（适用于部署环境）：将 SSH 公钥添加到 GitLab 账户，确保系统能通过 SSH 拉取代码。
使用 Token 时，Composer 会提示输入用户名和密码。你可以将 Token 当作密码使用，用户名可填任意值（如 token）或你的 GitLab 用户名。
也可以在 auth.json 文件中预先配置，避免每次输入：
{
"http-basic": {
"gitlab.example.com": {
"username": "your-username",
"password": "your-personal-access-token"
}
}
}
该文件应放在项目根目录或 Composer 的全局配置目录（通常为 ~/.config/composer/auth.json）。
3. 确保私有包符合 Composer 规范
目标仓库必须包含正确的 composer.json 文件，并声明其名称和自动加载规则，例如：
{
"name": "vendor/private-package",
"autoload": {
"psr-4": {
"Vendor\\PrivatePackage\\": "src/"
}
}
}
确保该名称与主项目中 require 字段一致，否则无法正确加载。
4. 执行安装命令
完成上述配置后，运行：
composer install
Composer 会通过 VCS 方式克隆私有仓库并安装依赖。若遇到权限错误，请检查 Token 权限、网络访问及域名拼写。
基本上就这些。只要配置好仓库地址、认证方式和包结构，Composer 就能顺利加载私有 GitLab 项目。
