配置Composer访问私有GitHub Enterprise仓库需先创建具有repo权限的PAT，通过composer config -g设置全局认证，再在composer.json中添加type为vcs的仓库地址，确保包名与name字段一致；也可改用SSH方式并配置对应密钥。
Composer 可以通过配置访问私有的 GitHub Enterprise 仓库，关键在于身份认证和正确的仓库声明方式。下面是如何实现这一目标的详细说明。
配置 OAuth Token 进行身份验证
GitHub Enterprise 不允许使用密码进行 Git 操作，必须使用个人访问令牌（Personal Access Token, PAT）来授权。
- 登录 GitHub Enterprise 账户，进入 Settings → Developer settings → Personal access tokens
- 生成一个新 token，确保勾选 repo 权限（用于私有仓库读取）
- 复制生成的 token
- 在本地运行：composer config -g github-oauth.github.yourdomain.com YOUR_TOKEN（将域名替换为你的 GHE 地址）
该命令会把 token 写入全局 composer 配置（通常位于 ~/.config/composer/auth.json），后续请求将自动携带认证信息。
在 composer.json 中声明私有仓库
如果要安装的包不在 Packagist 上，需在项目 composer.json 中显式添加仓库源。
{
"repositories": [
{
"type": "vcs",
"url": "https://github.yourcompany.com/your-team/your-private-package"
}
],
"require": {
"your-team/your-private-package": "dev-main"
}
}
Composer 会通过 VCS 驱动克隆该仓库，并使用之前配置的 OAuth Token 认证。注意：包名必须与 composer.json 中定义的 name 字段一致。
使用 SSH 替代 HTTPS（可选）
如果你更倾向于使用 SSH 访问：
- 确保已在 GitHub Enterprise 添加了 SSH 公钥
- 将仓库 URL 改为 SSH 格式：git@github.yourcompany.com:your-team/your-private-package.git
- Composer 会调用系统 ssh-agent 完成认证，无需额外配置
这种方式适合已配置好 SSH 密钥的工作环境，避免 token 管理问题。
常见问题处理
若遇到认证失败或无法克隆：
- 确认 token 是否具有足够权限（至少 repo）
- 检查 GHE 域名拼写是否与 config 中一致
- 尝试手动 git clone 该地址，排除网络或 SSH 配置问题
- 启用 Composer 调试模式：composer install -vvv 查看详细日志
基本上就这些。只要认证到位、仓库配置正确，Composer 就能顺利拉取私有 GHE 包。不复杂但容易忽略细节。
