先添加私有Git仓库源，再配置身份认证。使用composer config repositories.别名 vcs 仓库地址将私有仓库加入composer.json；通过SSH密钥或HTTPS+Token方式认证；确保仓库含合法composer.json后，用composer require安装包；注意权限及全局配置风险。
要在 Composer 中添加一个私有的 Git 仓库作为自定义 VCS 源，你可以使用 composer config 命令来配置 repositories。这个操作会修改项目的 composer.json 或 composer.lock 所在目录下的 config.json（通常位于 ./composer/config.json 或全局配置中），将你的私有 Git 仓库加入搜索源。
1. 使用命令添加私有仓库
在项目根目录下运行以下命令：
composer config repositories.foo vcs https://your-private-git-repo.com/username/project.git
-
repositories.foo：其中
foo是你为该仓库起的任意别名，比如也可以写成my-private-repo。 - vcs：表示这是一个版本控制系统（如 Git、Mercurial 等）。
- URL：填写你的私有 Git 仓库地址，支持 HTTPS 或 SSH。
执行后，Composer 会在当前项目的 composer.json 中生成或更新如下内容：
"repositories": {
"foo": {
"type": "vcs",
"url": "https://your-private-git-repo.com/username/project.git"
}
}
2. 访问私有仓库的身份认证方式
根据你使用的协议，需要确保 Composer 能通过身份验证访问仓库：
-
SSH 方式（推荐）：
使用git@...格式的 URL，例如：composer config repositories.foo vcs git@gitlab.com:username/private-project.git
前提是你已经在本地配置好 SSH 密钥，并添加到 Git 服务（如 GitHub、GitLab、Gitee 等）。 -
HTTPS + Token（无密码）：
可以使用个人访问令牌（Personal Access Token）代替密码。
例如：composer config repositories.foo vcs https://oauth2:YOUR-TOKEN@gitlab.com/username/private-project.git
注意：不要把真实 token 提交到版本控制中。
3. 安装来自私有仓库的包
只要私有仓库中包含合法的 composer.json 文件并设置了正确的名称（如 "name": "vendor/private-package"），你就可以像安装其他包一样 require 它：
composer require vendor/private-package
Composer 会自动从你配置的私有仓库拉取代码。
4. 注意事项
- 该命令只影响当前项目，除非你加上
--global参数（不推荐用于项目相关源）。 - 如果私有仓库是 Bitbucket、GitLab、GitHub 私有库，Composer 会尝试用 Git 克隆，所以系统必须安装 Git 并可用。
- 若遇到权限问题，可运行
composer install -vvv查看详细错误日志。 - 别名（如
foo）仅用于标识，不影响包的加载逻辑。
