Composer下载依赖包时如何避免连接超时-composer-PHP中文网

卡在downloading https:// 时应调 http.timeout，该参数控制dns解析、tls握手、首字节等待及整个body传输的总时间，默认300秒，弱网下易超时，需同步调高php的default_socket_timeout。

composer下载依赖包时如何避免连接超时

卡在Downloading https:// 时该调 `http.timeout`

这是 HTTP 请求阶段卡住，比如拉 packages.json、下载 ZIP 包，错误里常带 cURL error 28 或反复 retry 后失败。它不看 process-timeout，只认 http.timeout（Composer 2.x）。

http.timeout 控制 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输的总时间，单位秒，默认仅 300（5 分钟），弱网下极易触发。

项目级最稳：运行 composer config http.timeout 600，写入当前 composer.json 的 config 段，可提交、可复现
全局生效：用 composer config -g http.timeout 600，写入 ~/.composer/config.json
临时覆盖优先级最高：COMPOSER_HTTP_TIMEOUT=1200 composer install，适合 CI 调试

注意：php -i | grep default_socket_timeout 查出的 PHP CLI default_socket_timeout 若低于你设的 http.timeout，会提前掐断连接——常见值是 60，务必同步调高。

`The process timed out` 错误该调 `process-timeout`

这是子进程执行太久被杀，比如 git clone、unzip、跑 post-install-cmd 脚本。错误里一定含 [RuntimeException] The process "" exceeded the timeout，加 -vvv 可看到最后那条命令。

process-timeout 控制单个外部命令最大执行时间，单位秒，默认 300，和 HTTP 完全无关。

全局改：运行 composer config -g process-timeout 1800（30 分钟），写入 ~/.composer/config.json
项目级改：直接在 composer.json 顶层加 "config": {"process-timeout": 1200}
临时覆盖：用 COMPOSER_PROCESS_TIMEOUT=1800 composer install 或命令行参数 --process-timeout=1800

注意：该值设为 0 表示禁用超时，但可能卡死无响应；调试建议先设 600，确认能走通再调高。

Discussion Composer

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

下载

换源只是辅助，关键要配对使用 `http.timeout` 和 `process-timeout`

国内用户常因源不稳定或 DNS 解析慢触发超时，但错误提示往往只显示 Failed to download，掩盖了真实瓶颈。

阿里云镜像仍是目前最稳定可用的国内源：

设镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
禁用 fallback：composer config -g repo.packagist false（防止 Composer 自动回退到官方源拖慢流程）
验证是否生效：composer config -g repo.packagist 应输出对应 URL

注意：换源后仍可能超时——因为某些包（尤其 "type": "git"）会绕过镜像直连 GitHub，此时必须靠 process-timeout 撑住 git clone 阶段；必要时还可配 Git 自身超时：git config --global core.sshCommand "timeout 300 ssh"（Linux/macOS）。

为什么调了 `http.timeout` 还失败？检查 `default_socket_timeout` 和镜像回源

最容易被忽略的是 PHP 层级的 socket 限制。即使你把 http.timeout 设为 1200，若 PHP 的 default_socket_timeout 是默认 60，cURL 底层会在 60 秒就中断，Composer 根本等不到自己的超时逻辑生效。

另一个隐蔽点是镜像配置未真正生效：很多教程只教设 repo.packagist，但没关掉 fallback。Composer 默认在镜像失败后会自动尝试 packagist.org，这一来回可能耗尽全部超时时间。

验证方式：

查 PHP 设置：php -i | grep default_socket_timeout，若 ≤ 300，建议同步设为 1200
查镜像状态：composer config -g repo.packagist 和 composer config -g --list | grep -i fallback
观察日志：composer update -vvv 中出现 https://packagist.org 就说明 fallback 仍在工作