先配置GitLab仓库和认证，再安装私有包。在composer.json中添加GitLab群组或项目级别的Package Registry地址，生成含read_package_registry权限的Personal Access Token，通过composer config或auth.json配置http-basic认证，最后执行composer require vendor/your-private-package拉取包，注意检查权限、路径及URL正确性。
在使用私有 GitLab 仓库的 Composer 包时，你需要配置 Composer 访问 GitLab Package Registry，并完成身份认证。这个过程包括添加仓库源、提供访问令牌，确保 Composer 能拉取私有包。下面是具体操作步骤。
配置 GitLab 作为 Composer 仓库
要在项目中使用 GitLab 的私有 Composer 包，先在项目的 composer.json 中声明 GitLab 的仓库地址。
打开 composer.json 文件，在 repositories 字段中添加 GitLab Package Registry 的 URL：
{ "repositories": [ { "type": "composer", "url": "https://gitlab.com/api/v4/groups/GROUP_ID/-/packages/composer/" } ] }其中 GROUP_ID 是你的 GitLab 群组 ID（可在群组设置页面找到），如果是项目级别的包，则使用项目路径或 ID 替代。
生成并配置 Personal Access Token
GitLab 使用 Personal Access Token (PAT) 进行 Composer 认证。你需要创建一个具有 read_package_registry 权限的 token。
操作步骤如下：
- 登录 GitLab，进入用户设置 → Access Tokens
- 填写 Token 名称，例如 “composer-read”
- 勾选 read_package_registry 权限
- 生成 Token 并复制保存（一旦关闭页面将无法再次查看）
然后在本地 Composer 配置中添加认证信息：
composer config http-basic.gitlab.com YOUR_USERNAME YOUR_TOKEN
或者直接编辑全局配置文件 auth.json（推荐用于多项目管理）：
{ "http-basic": { "gitlab.com": { "username": "your-username", "password": "your-access-token" } } }该文件通常位于 ~/.config/composer/auth.json（Linux/macOS）或 C:\Users\用户名\AppData\Roaming\Composer\auth.json（Windows）。
安装私有包并验证
完成配置后，就可以像使用公共包一样 require 私有包：
composer require vendor/your-private-packageComposer 会通过配置的 GitLab registry 查找并下载包。如果出现 403 错误，请检查：
- Token 是否具备 read_package_registry 权限
- 是否将包发布到了正确的群组或项目
- composer.json 中的仓库 URL 是否正确
基本上就这些。只要配置好仓库地址和认证凭据，Composer 就能顺利拉取 GitLab 上的私有 PHP 包。不复杂但容易忽略权限和路径细节。
