答案：配置SSH认证并添加VCS仓库。具体：生成SSH密钥并添加至GitLab，测试连接；在composer.json中添加type为vcs的SSH仓库地址；确保私有包的composer.json包含正确name字段；通过dev-分支或标签引用；可选配置全局Token或SSH别名优化认证。
要在 Composer 中使用公司内部的 GitLab 仓库，关键是让 Composer 能够访问私有 Git 仓库并正确拉取代码。这通常涉及配置 SSH 认证、添加自定义 VCS 仓库以及设置正确的包信息。以下是具体操作步骤。
配置 SSH 访问权限
Composer 拉取 GitLab 私有项目依赖的是 Git 协议，推荐使用 SSH 方式认证：
- 确保本地已生成 SSH 公钥和私钥（通常在 ~/.ssh/id_rsa.pub）
- 将公钥添加到你的 GitLab 账户的 SSH Keys 设置中
- 测试连接：ssh -T git@your-gitlab-domain.com，应看到欢迎信息
这样 Composer 就能通过 SSH 拉取代码而无需每次输入密码。
在 composer.json 中声明 GitLab 仓库
如果要使用的包不在 Packagist 上，需在项目的 composer.json 中手动添加仓库：
{
"repositories": [
{
"type": "vcs",
"url": "git@gitlab.yourcompany.com:group/project-name.git"
}
],
"require": {
"group/project-name": "dev-main"
}
}
注意：
- type 设为 vcs，表示这是一个版本控制系统仓库
- url 使用 SSH 地址，格式为 git@domain:group/repo.git
- require 的包名通常由 GitLab 的组名和项目名组成，也可在目标项目的 composer.json 中查看实际的 name 字段
处理私有包的名称与版本
确保 GitLab 中的目标项目根目录有正确的 composer.json 文件，例如：
{
"name": "company/utils",
"type": "library",
"autoload": {
"psr-4": {
"Company\\Utils\\": "src/"
}
}
}
之后你可以在主项目中 require 这个名字："company/utils": "dev-develop" 或打上 tag 后使用如 "1.0.0"。
分支或标签需明确指定，常见写法：
- dev-main：使用 main 分支最新代码
- dev-develop：使用 develop 分支
- 1.2.0：使用某个 tag 版本
优化体验：配置全局 GitLab OAuth 或 SSH 别名
若使用 HTTPS 而非 SSH，可通过 GitLab Personal Access Token 配置：
composer config --global gitlab-token.gitlab.yourcompany.com your-access-token-here或者在项目中运行：
composer config gitlab-token.gitlab.yourcompany.com xxxxx这样 Composer 可自动认证 HTTPS 请求。
对于多个项目频繁访问，还可配置 SSH config 文件简化域名：
# ~/.ssh/config
Host gitlab
HostName gitlab.yourcompany.com
User git
IdentityFile ~/.ssh/id_rsa
然后仓库 URL 可简写为：git@gitlab:group/project.git
基本上就这些。只要 SSH 或 Token 认证到位，加上正确的仓库和包名配置，Composer 就能顺利加载内部 GitLab 项目。不复杂但容易忽略细节，比如分支命名或包名匹配问题。
