Composer 默认不识别私有VCS平台，需通过自定义VcsDriver类注入适配器：继承GitDriver或实现VcsDriverInterface，重写supports()匹配私有域名，注册驱动后才能使composer require正常解析URL并处理认证。
Composer 默认只识别 git、svn、hg 这几种 VCS 类型，遇到私有平台（比如内部 GitLab 替代品、自研代码托管系统、或带鉴权代理的 SVN 网关），直接写 "type": "vcs" 会失败——不是报 Repository not found，就是卡在 clone 阶段无响应。根本原因在于 Composer 的 VcsDriver 体系不支持任意 URL 协议或认证模型，必须显式注册适配器。
怎么让 Composer 认出你的私有 VCS 地址？
关键不是改 composer.json，而是注入自定义 VcsDriver 类。Composer 启动时通过 Composer\Repository\VcsRepository 加载驱动，它依赖 Composer\Repository\Vcs\VcsDriver 的静态 create() 方法匹配 URL 模式。你得提供一个能响应你域名/协议的驱动类：
- 新建类如
MyCompany\PrivateGitDriver，继承Composer\Repository\Vcs\GitDriver（若底层仍是 Git）或实现Composer\Repository\Vcs\VcsDriverInterface - 重写
supports()：返回true当$url匹配你的私有域，例如return strpos($url, 'https://git.internal.company/') === 0; - 重写
getScheme()或直接复用GitDriver的逻辑，但修改getOriginUrl()做路径转换（比如把https://git.internal.company/repo转成真实可 clone 的ssh://git@git.internal.company:2222/repo.git） - 在插件中注册：通过
PluginInterface::activate()调用VcsRepository::addVcsDriver('mycompany-git', MyCompany\PrivateGitDriver::class)
为什么 composer require 失败但 git clone 手动成功？
常见现象：你在终端能 git clone https://git.internal.company/foo/bar 成功，但 composer require vendor/package 报 Failed to clone https://git.internal.company/foo/bar。这不是网络问题，是 Composer 没选对驱动：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Composer 对 URL 做正则匹配，
https://git.internal.company/...不满足默认GitDriver::supports()的github|gitlab|bitbucket域名白名单 - 即使你强制加
"type": "vcs"，Composer 仍会跳过你的 URL，因为VcsRepository初始化时已按默认驱动列表试了一遍，没匹配就直接抛异常 - 解决办法不是改
composer.json的repositories，而是确保你的插件在composer install前已激活并注册了驱动——检查composer show --plugins是否列出你的插件
私有 VCS 驱动里怎么处理 Token 或 SSH 密钥？
不能硬编码凭证，也不能依赖用户手动配 auth.json（因为 auth.json 只支持标准域名）。正确做法是驱动内部接管认证：
- 在
initialize()或getInstallablePackages()中读取环境变量，如getenv('MYCOMPANY_VCS_TOKEN') - 若用 SSH，确保
ssh-agent已加载对应密钥，或在getOriginUrl()返回带用户信息的 URL：ssh://git-mycorp@git.internal.company:2222/repo.git，再配合~/.ssh/config配置Host git.internal.company的IdentityFile - 避免在驱动里调用
exec('git config')—— 这会污染全局 Git 配置，且 CI 环境不可靠；优先走 URL 重写 + 环境变量
兼容 Composer 2.5+ 的注意事项
Composer 2.5 开始强化了 VCS 驱动的安全校验，几个易踩坑点：
-
VcsDriver::getContentsUrl()必须返回绝对 URL，且协议需与getOriginUrl()一致，否则composer update会跳过该包 - 自定义驱动类必须声明
public function getComposerInformation($commitRef)，不能直接抛NotImplementedException；至少返回空数组或从远程 API 获取composer.json内容 - 如果私有平台返回的 commit hash 是 40 位，但你的驱动传给
getCommitLogs()的是缩写（如 7 位），会导致Could not parse version constraint错误——始终用完整 hash
真正麻烦的不是写驱动，是让 Composer 在解析 repositories 列表前就加载它。很多团队卡在这一步：插件注册时机晚于仓库初始化，结果驱动根本没生效。务必把插件放在项目根目录的 composer.json 的 require 里，而不是 dev-dependencies，且确保它的 autoload 能被 Composer 自动发现。
