解决慢速下载的Composer代理配置方案-composer-PHP中文网

composer卡在loading或downloading是因未同时配置http-proxy和https-proxy：二者必须均为http://开头且端口完整，缺一则https请求静默直连失败；验证需用composer config -g --list | grep -e "(http|https)-proxy"。

解决慢速下载的composer代理配置方案

Composer 卡在 Loading composer repositories 或反复出现 Downloading https://api.github.com/，不是镜像没配对，而是根本没走代理——http-proxy 和 https-proxy 必须同时显式配置，缺一不可。

为什么只设 http-proxy 会静默失败

Composer 对 HTTP 和 HTTPS 请求路由完全分离：前者走 http-proxy，后者必须走 https-proxy 字段，且该字段值**必须是 http:// 开头的地址**（哪怕代理本身监听 TLS 端口）。漏掉 https-proxy，所有元数据请求（如 https://packagist.org/packages.json）都会 fallback 到直连，最终超时或卡住，日志里却无明确报错。

https-proxy 填成 https://127.0.0.1:7890 或漏协议头（如 127.0.0.1:7890）→ 静默忽略，等效于未配置
密码含 @、/、: 必须 URL 编码，例如 pa@ss/word → pa%40ss%2Fword
Windows 下若提示 Could not write to file，检查 %APPDATA%\Composer\config.json 是否可写

正确配置全局代理的命令

运行以下两条命令，确保两者都写入全局配置（~/.composer/config.json 或 %APPDATA%\Composer\config.json）：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

composer config -g repo.packagist.org.proxy http://127.0.0.1:7890
composer config -g repo.packagist.org.ssl-proxy http://127.0.0.1:7890

代理地址必须带端口，例如 http://127.0.0.1:7890；SOCKS5 仅 Composer ≥ 2.2 支持：socks5://127.0.0.1:7891
取消代理用：composer config -g --unset repo.packagist.org.proxy 和 composer config -g --unset repo.packagist.org.ssl-proxy
验证是否生效：composer config -g --list | grep -E "(http|https)-proxy"，应输出两行且格式正确

代理配好仍卡住？快速定位三层故障点

现象一致，但问题可能在任意一层：

curl -x http://127.0.0.1:7890 -I https://packagist.org/packages.json 返回 407 Proxy Authentication Required → 代理需 NTLM 认证，Composer 原生不支持，得用 cntlm 或 px 中转
curl 正常但 Composer 卡住 → 检查是否误配了 repo.packagist 镜像源，代理和镜像不可共存，二者选一
curl 也超时或 No route to host → 本地代理进程未启动、端口填错、或防火墙拦截

公司内网或 CI 场景下别硬上代理

阿里云、腾讯云等镜像站已提供完整同步且走内网直连，此时配代理反而多一层故障点。优先确认：

是否已运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
composer install -vvv | grep "Loading composer repositories" 输出中是否含 mirrors.aliyun.com 而非 packagist.org
若 composer.lock 中 dist URL 仍是 github.com，删 lock 文件再重试，否则镜像和代理都无效

真正卡点往往藏在 composer.lock 里固化的 GitHub ZIP 地址，而不是元数据加载阶段——代理只管 HTTPS 请求链路，不管 lock 文件里写死的下载路径。