Composer私有仓库自定义主机名访问问题求助

1. 调整SSH配置，自动匹配目标仓库使用次级密钥 #

无需修改任何Composer文件，直接在~/.ssh/config中添加匹配规则，让访问指定GitHub仓库时自动调用次级密钥：

# 保留原有custom-git-host配置
Host custom-git-host
    HostName github.com
    User git
    IdentityFile ~/.ssh/secondary_id_rsa
    IdentitiesOnly yes

# 添加规则：仅针对repo命名空间下的仓库使用次级密钥
Match host github.com exec "echo %h:%r | grep -q 'github.com:repo/'"
    IdentityFile ~/.ssh/secondary_id_rsa
    IdentitiesOnly yes

配置完成后，Composer使用git@github.com:repo/package-1.git拉取依赖时，SSH会自动切换到次级密钥，无需改动项目中的Composer配置文件。

2. 批量替换composer.lock中的仓库URL #

如果不想调整SSH配置，可通过命令行快速替换lock文件中的旧URL：

# Linux/macOS环境
sed -i 's/git@github.com:repo\/package-1.git/git@custom-git-host:repo\/package-1.git/g' composer.lock

# Windows PowerShell环境
(Get-Content composer.lock) -replace 'git@github.com:repo/package-1.git', 'git@custom-git-host:repo/package-1.git' | Set-Content composer.lock

替换完成后执行composer install即可正常拉取依赖。

3. 强制Composer使用composer.json的仓库配置（保留版本） #

修改composer.json中的仓库URL后，执行以下命令更新lock文件的仓库记录但不升级包版本：

composer update vendor/package-1 --lock

该命令会重新生成lock文件中对应包的仓库信息，同时保持版本号不变，之后执行composer install即可。

问题相关解答 #

• Composer没有原生支持主机名替换的功能，无法直接将github.com映射到custom-git-host。
• 临时修改composer.json和composer.lock不是唯一解决方案，通过调整SSH配置可以彻底解决问题，无需改动项目文件。

内容的提问来源于stack exchange，提问作者Pavi