如何在Composer镜像中利用 Git 镜像加速仓库克隆-composer-PHP中文网

composer镜像仅加速元数据和dist包下载，对git clone无效；cloning卡住需优化git层：换国内镜像地址、改用ssh、配置http超时及压缩，并确保ci中git配置被正确读取。

如何在composer镜像中利用 git 镜像加速仓库克隆

Composer镜像本身不加速git clone

别被“镜像”二字误导：Composer配置的国内镜像（如https://mirrors.aliyun.com/composer/）只加速packages.json元数据下载和.zip分发包（dist）拉取，对git clone行为完全无效。当你看到Cloning into 'xxx'...卡住，问题一定出在Git层，不是Composer镜像没配好。

真正影响git clone速度的是Git仓库地址和协议

Composer在安装依赖时，若包声明了"source"类型或未提供dist包，就会触发git clone。此时它用的是composer.json里repositories定义的URL，或Packagist记录的原始Git地址（比如https://github.com/laravel/framework.git）。这个URL才是关键。

直接克隆GitHub原始地址 → 受限于跨境网络，大概率超时或极慢
换成Gitee、GitCode等国内镜像地址 → 速度提升明显，但前提是该仓库已同步且URL正确
改用SSH协议（如git@gitee.com:xxx/yyy.git） → 绕过HTTPS证书验证和DNS解析，连接更稳
私有仓库必须确保认证可用：SSH密钥已加载，或Token已注入环境变量（不用明文写进composer.json）

如何让Composer自动用Git镜像替代原始地址

Composer不内置Git URL重写功能，但可通过repositories显式覆盖源。注意这不是“全局替换”，而是按包逐个声明：

Lovefromio Github

使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。

下载

在项目composer.json中添加repositories字段，把原包的GitHub地址替换成Gitee镜像地址
必须保持"type": "vcs"，且"url"指向一个可git clone的裸仓库（不是网页URL）

示例：

"repositories": [
  {
    "type": "vcs",
    "url": "https://gitee.com/mirrors/laravel-framework.git"
  }
]

如果原包是私有的，Gitee镜像也得是私有+认证通过；公开包才能直接用公开镜像
别指望靠repo.packagist配置影响Git行为——它只管元数据索引，不管代码怎么拉

Git层必须单独调优，否则Composer镜像再快也没用

即使你把所有包都指向Gitee，Git本身仍可能因超时中断。这些配置必须手动设：

增大HTTP缓冲：git config --global http.postBuffer 524288000
放宽低速限制：git config --global http.lowSpeedLimit 0 + git config --global http.lowSpeedTime 999999
启用并发克隆：git config --global core.compression 9（压缩级别最高）
确认git -c core.askpass= echo clone https://gitee.com/xxx/yyy.git能静默执行，否则CI中会卡在交互提示

最易忽略的一点：Git配置是全局生效的，但Composer进程是否读取它们，取决于运行时的$HOME和~/.gitconfig权限。CI环境常以无主目录用户运行，容易漏掉这层配置。