如何解决Composer在低速网络环境下的下载失败问题？ (http-downloader配置)

启用 http-downloader 可缓解低速网络下载失败，因其改用 curl 替代默认 stream，支持断点续传、细粒度超时、自动重试和连接复用。需在 config 中设 “http-downloader”: “curl” 并调优 http-timeout、process-timeout 等参数。

为什么 http-downloader 配置能缓解低速网络下载失败？

composer 默认使用 php 的 stream_get_contents() + fopen() 下载包，对弱网、高延迟、频繁重连的环境非常不友好。启用 http-downloader 后，它会改用 cURL 作为底层传输引擎，支持断点续传、更细粒度的超时控制、自动重试和连接复用——这些是解决“Connection timed out”或“file could not be downloaded”的关键。

如何启用并调优 http-downloader？

需在 composer.json 或全局配置中显式开启，并覆盖默认的脆弱参数：

• "http-downloader": "curl" 是强制开关（不设则默认回退到 stream）
• "http-basic": {} 不影响下载器选择，但若私库需认证，必须配在此处而非 auth.json 外部文件（否则 cURL 不读取）
• 关键超时值建议设为： "process-timeout": 300（整个命令上限）、"http-timeout": 60（单次 HTTP 请求）、"github-protocols": ["https"]（避免 ssh 协商失败）

{     "config": {         "http-downloader": "curl",         "http-timeout": 60,         "process-timeout": 300,         "github-protocols": ["https"],         "secure-http": true     } }

常见错误现象与对应配置修正

遇到以下报错时，大概率是 http-downloader 未生效或参数不合理：

• Failed to decode response: zlib_decode(): data Error → 关闭 cURL 的自动解压："disable-tls": false 且确保没手动设 CURLOPT_ENCODING
• Could not fetch https://repo.packagist.org/packages.json, please review your configured sources → 检查是否误配了 "secure-http": false 被强制拦截；或代理环境未设 HTTP_proxy/HTTPS_PROXY 环境变量
• 下载中途卡住数分钟才报错 → "http-timeout" 过小（如 10），应设为 45–60；同时确认系统级 cURL 版本 ≥ 7.52.0（旧版不支持 http-downloader 的完整重试逻辑）

本地调试：验证 http-downloader 是否真正启用

运行 composer config --list 只显示配置项，不反映运行时行为。真实验证方式是加 -v 并观察日志开头：

$ composer install -v 2>&1 | head -n 5 Loading config file /home/user/.composer/config.json Loading config file /home/user/.composer/auth.json Reading ./composer.json Loading config file ./composer.json Downloading https://repo.packagist.org/packages.json using curl

最后一行出现 using curl 才表示生效。若仍显示 using stream，说明配置位置错误（如写在子项目 composer.json 但当前在父目录执行）、或被 COMPOSER_HOME 下的全局配置覆盖。

低速网络下最易被忽略的是 cURL 自身的 dns 缓存和连接池行为——哪怕配置全对，首次安装仍可能因域名解析慢卡住，此时加 "cache-files-ttl": 0 反而加重压力；建议保留默认缓存，仅调大超时和重试次数。