首先配置composer.json的repositories字段添加私有Git仓库地址，使用type为vcs和SSH格式的url；然后确保本地或部署环境已配置SSH密钥，将公钥添加到Git平台账户或项目部署密钥中；接着验证目标仓库包含正确的composer.json文件且包名与require中一致；最后可在全局设置Git URL重写规则以统一使用SSH协议。整个过程需注意权限、命名匹配及CI/CD环境的密钥配置。
在使用 Composer 管理 PHP 项目依赖时，有时需要引入存放在私有 Git 仓库中的包。由于这些仓库不公开，Composer 默认无法访问，因此需要额外配置才能正常加载。下面教你如何通过 Composer 正确加载私有 Git 仓库的依赖包。
配置私有仓库地址
Composer 支持通过 repositories 字段添加自定义仓库。你需要在项目的 composer.json 文件中声明私有 Git 仓库的位置。
示例配置：
{
"repositories": [
{
"type": "vcs",
"url": "git@gitlab.com:your-company/your-private-package.git"
}
],
"require": {
"your-company/your-private-package": "dev-main"
}
}
说明：
- type: vcs 表示这是一个版本控制系统（如 Git）托管的仓库。
- url 使用 SSH 地址（推荐），确保你有权限访问。
- require 中的包名需与目标仓库的 composer.json 中定义的 name 字段一致。
配置 SSH 访问权限
私有仓库通常通过 SSH 验证身份。你需要确保本地机器或部署环境已配置好 SSH 密钥对，并将公钥添加到 Git 服务（如 GitHub、GitLab、Gitee 等）的部署密钥或用户 SSH 设置中。
操作步骤：
- 生成 SSH 密钥：ssh-keygen -t rsa -b 4096 -C "your@email.com"
- 查看公钥：cat ~/.ssh/id_rsa.pub，复制内容
- 登录 Git 平台，将公钥添加至账户或项目部署密钥中
- 测试连接：ssh -T git@gitlab.com（以 GitLab 为例）
使用私有包的注意事项
为了让 Composer 成功安装私有包，还需注意以下几点：
- 目标仓库必须包含有效的 composer.json 文件，且 name 和 version（或通过分支/标签推断）正确。
- 如果使用分支作为版本，建议使用 dev- 前缀，如 dev-main 或 dev-develop。
- 某些 CI/CD 环境需要单独配置 SSH 密钥，可通过环境变量注入私钥。
- 避免在 composer.json 中硬编码敏感信息。
全局配置 Git 处理方式（可选）
如果你希望 Composer 统一使用 SSH 而非 HTTPS 拉取 Git 包，可以设置 Git 的 URL 重写规则：
git config --global url."git@gitlab.com:".insteadOf "https://gitlab.com/"
这样即使仓库配置的是 HTTPS 地址，也会自动转为 SSH 拉取，便于私有项目访问。
基本上就这些。只要仓库可访问、SSH 配置正确、包名匹配，Composer 就能顺利加载私有 Git 仓库中的依赖。整个过程不复杂，但容易忽略权限和命名一致性问题。
