可通过 Composer 的 repositories 配置将私有 Git 仓库作为包源，需声明 type 为 vcs、正确填写 URL（HTTPS+Token 或 SSH），并确保网络可达与认证有效，再在 require 中按 name 字段声明依赖并安装。
可以通过 Composer 的 repositories 配置，将私有 Git 仓库作为包源加载。关键在于正确声明仓库类型、URL 和认证方式，确保 Composer 能拉取代码并解析 composer.json。
1. 在项目根目录的 composer.json 中配置私有仓库
在项目的 composer.json 文件中添加 repositories 字段，指定仓库类型为 vcs（Version Control System），并填入 Git 仓库地址：
- 支持 HTTPS 或 SSH 协议，HTTPS 更易配合 Token 认证，SSH 更适合已有密钥环境
- 仓库 URL 必须可被本地机器访问（如
https://gitlab.example.com/mygroup/mypackage.git或git@gitlab.example.com:mygroup/mypackage.git） - 不需要提前克隆仓库，Composer 会在安装时自动处理
2. 使用 SSH 方式（推荐用于 CI/CD 或团队开发）
确保当前系统已配置好 SSH 密钥，并能通过 ssh -T git@host 正常连接 Git 服务器：
- 在
composer.json中写入：
{
"type": "vcs",
"url": "git@gitlab.example.com:mygroup/mypackage.git"
}
]
- Composer 会调用系统
git命令，自动使用默认 SSH 密钥（通常为~/.ssh/id_rsa） - 若需指定非默认密钥，可通过
~/.ssh/config配置 Host 别名并绑定 IdentityFile
3. 使用 HTTPS + Personal Access Token（推荐用于 GitHub/GitLab 私有库）
避免明文密码，用 Token 替代用户名密码进行认证：
- 生成 Token：GitHub 在 Settings → Developer settings → Personal access tokens；GitLab 在 User Settings → Access Tokens，勾选
read_repository - 在
composer.json中写入完整带 Token 的 HTTPS 地址（注意 URL 编码特殊字符）：
{
"type": "vcs",
"url": "https://oauth2:YOUR_TOKEN_HERE@gitlab.example.com/mygroup/mypackage.git"
}
]
- 也可全局配置 Git 凭据缓存：
git config --global credential.helper store，然后执行一次git clone https://token:x-oauth-basic@gitlab.example.com/...，后续 Composer 自动复用
4. 声明依赖并安装
在 require 中按包名引入（包名需与私有仓库中 composer.json 的 "name" 字段一致）：
- 例如私有仓库内
composer.json含"name": "mygroup/mypackage"，则 require 写："mygroup/mypackage": "dev-main"（分支名）或"dev-develop"、"v1.0.0"（Tag） - 运行
composer update mygroup/mypackage或composer install，Composer 会从私有仓库拉取对应版本 - 如遇
Could not fetch错误，先手动执行git ls-remote -h https://...验证网络和权限是否正常
