Composer支持通过VCS加载私有或未发布Git仓库，需在composer.json中添加repositories配置指向Git地址，如{"type":"vcs","url":"https://github.com/username/private-package.git"}；随后使用composer require vendor/package-name安装依赖，包名需与Git项目中composer.json的name字段一致；可指定分支或标签，如dev-develop或v1.0.0，通过版本约束确保稳定性；访问私有仓库时推荐配置SSH密钥，或在auth.json中设置HTTPS凭证完成认证。
如果您在使用 Composer 管理 PHP 项目依赖时需要引入私有 Git 仓库或尚未发布到 Packagist 的项目，Composer 支持通过 VCS（版本控制系统）直接加载 Git 仓库作为依赖。以下是实现该功能的具体操作方式。
本文运行环境：MacBook Pro，macOS Sonoma
一、配置 VCS 仓库源
Composer 通过自定义仓库类型为
vcs来识别 Git 仓库地址。您需要在项目的 composer.json 文件中声明该仓库的位置，以便 Composer 能够从指定的 Git 地址拉取代码。
1、打开项目根目录下的 composer.json 文件。
2、在文件顶部添加 repositories 字段，并设置类型为 vcs，指向目标 Git 仓库的 URL。
3、示例配置如下：
"repositories": [{"type": "vcs","url": "https://github.com/username/private-package.git"}]
二、添加 Git 项目作为依赖
在成功声明 VCS 仓库后，您可以像安装普通 Composer 包一样 require 对应的包名。Composer 会优先检查已注册的仓库来解析该依赖。
1、执行命令 composer require vendor/package-name，其中 vendor 和 package-name 应与 Git 项目中的 composer.json 定义的名称一致。
2、如果 Git 项目未在 Packagist 上注册，但其内部包含正确的 name 字段，Composer 将从您配置的 VCS 地址下载。
3、若未指定分支，默认拉取 master 或 main 分支；可通过版本约束指定特定分支或标签。
三、指定分支或标签版本
为了确保依赖稳定性，可明确指定从 Git 仓库的某个分支、标签或提交进行安装。这有助于避免因主分支更新导致的不兼容问题。
1、使用 dev- 前缀加分支名来引用开发分支，例如：dev-develop。
2、直接使用标签名称，如 v1.0.0，Composer 会查找对应 Git tag。
3、在 require 命令中指定版本：
composer require vendor/package-name dev-feature/auth
4、或在 composer.json 的 require 字段中写明：
"vendor/package-name": "dev-hotfix/patch-2"
四、处理私有仓库认证
当访问私有 Git 仓库时，Composer 需要凭据授权。可通过 SSH 密钥或 HTTPS 凭证完成身份验证。
1、推荐使用 SSH 协议并提前将公钥添加至 Git 服务（如 GitHub、GitLab）账户。
2、若使用 HTTPS，Composer 会在首次请求时提示输入用户名和密码。
3、可预先配置 HTTP Basic Auth，在 auth.json 文件中存储凭证：
{"http-basic": {"github.com": {"username": "your-token", "password": ""}}}
4、将 auth.json 放置于项目根目录或全局 Composer 目录下以生效。
