GitLab的Package Registry支持私有Composer包托管，无需额外服务；2. 配置composer.json并确保包名与项目路径一致；3. 通过CI/CD在打标签时自动发布；4. 在其他项目中添加GitLab群组的包源并配置认证即可使用；5. 通过Packages and registries页面管理已发布版本。
GitLab 的 Package Registry 支持 Composer 包的私有托管，适合团队在项目中安全地共享 PHP 组件。你不需要额外搭建仓库服务，直接利用 GitLab 项目即可完成发布和使用。下面是如何配置和操作的完整流程。
启用并配置 Composer 包注册表
确保你的 GitLab 项目已开启 Package Registry 功能（默认开启）。你需要设置 composer.json 文件，声明包的基本信息，并添加对 GitLab 包源的引用。
在你要发布的 PHP 包项目根目录下，确认 composer.json 包含以下字段：
{ "name": "your-group/your-package-name", "description": "A private PHP package", "type": "library", "version": "1.0.0", "autoload": { "psr-4": { "YourNamespace\\": "src/" } } }注意： 包名必须与 GitLab 的群组/项目路径一致。例如，若项目地址为 https://gitlab.com/mygroup/myproject，则包名应为 mygroup/myproject。
通过 CI/CD 自动发布包
最推荐的方式是使用 GitLab CI 自动发布包。创建 .gitlab-ci.yml 文件：
stages: - deploypublish: stage: deploy script:
- 'curl --fail-with-body -sS --user "gitlab-ci-token:${CI_JOB_TOKEN}" "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/composer" -o composer.json'
- composer config http-basic.${CI_SERVER_HOST} gitlab-ci-token ${CI_JOB_TOKEN}
- composer publish rules:
- if: $CI_COMMIT_TAG # 仅在打标签时发布
该流程会在你推送 Git 标签时自动触发发布。确保版本号与 tag 一致，例如 v1.0.0。
你也可以手动使用命令行发布，但需先获取个人访问令牌（Personal Access Token）并配置认证：
composer config http-basic.gitlab.com your_username your_access_token composer publish在项目中使用私有 Composer 包
要在其他项目中安装这个私有包，需在目标项目的 composer.json 中添加 GitLab 的包源：
{ "repositories": [ { "type": "composer", "url": "https://gitlab.com/api/v4/groups/GROUP_ID/-/packages/composer" } ], "require": { "your-group/your-package-name": "^1.0" } }
说明：
- 替换 GROUP_ID 为你在 GitLab 中的实际群组 ID（可在群组设置页面找到）。
- 如果包属于子群组，URL 中需包含完整路径，如 /groups/parent%2Fsubgroup/...（注意 URL 编码斜杠为 %2F）。
然后配置认证，使 Composer 能拉取私有包：
composer config http-basic.gitlab.com gitlab-ci-token ${CI_JOB_TOKEN}在 CI 环境中，使用 CI_JOB_TOKEN 即可。本地开发时，可创建个人访问令牌（scopes 需包含 read_api），然后运行：
composer config http-basic.gitlab.com your_username your_personal_token查看和管理已发布的包
进入 GitLab 项目页面，点击左侧菜单的 Packages and registries，即可看到已发布的 Composer 包及其版本。你可以在此删除旧版本或查看安装说明。
每个版本对应一个 Git tag，不支持覆盖已发布版本。如需更新，请递增版本号并重新发布。
基本上就这些。配置一次后，后续发布和使用都只需标准 Composer 命令。关键是确保命名、权限和认证正确，整个流程就能顺畅运行。
