composer install 卡住需分三类处理：http 下载超时调 http.timeout（默认300秒），子进程超时调 process-timeout（默认300秒），大包下载中断调 http-basic-timeout（默认60秒），并注意 php default_socket_timeout 限制。

composer install 卡在 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 完全无关。

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 process-timeout 1800（30 分钟），写入 ~/.composer/config.json
• 项目级改：直接在 composer.json 顶层加 "config": {"process-timeout": 1200}
• CI 环境建议用环境变量兜底：COMPOSER_PROCESS_TIMEOUT=2000，某些 Composer 版本对它更敏感

Composer 2.2+ 还要留意 http-basic-timeout

这个参数控制单次 HTTP 请求的连接与读取时限，默认仅 60 秒，容易在大包下载中途断掉（比如拉 laravel/framework 的 dist ZIP）。它和 http.timeout 不同：后者是整条请求生命周期上限，前者是“等首字节”和“等后续数据”的分段限制。

• 临时用：composer install --http-basic-timeout=300
• 永久写入配置：composer config -g http-basic-timeout 300
• 旧版 Composer（--timeout 或换镜像硬扛

设为 0 表示不限时，但不建议——可能卡死无响应，尤其在 CI 中难以排查。

换源比调 timeout 更治本

单纯延长超时只是“等得更久”，不能解决网络抖动、DNS 污染、代理劫持这些根本问题。国内用户应优先切换镜像源，并确认它真正生效。

• 换阿里云源：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 验证是否生效：composer config -g repos.packagist.org 应输出镜像 URL
• 手动测源站：curl -v https://mirrors.aliyun.com/composer/packages.json，看是否卡在 * Connected to 后无响应
• 若手动 curl 也卡，尝试加 --resolve mirrors.aliyun.com:443:114.114.114.114 强制指定 DNS，排除本地 DNS 污染

开发机开了 Charles/Fiddler 必须关掉——Composer 不读 HTTP_PROXY，但系统级 curl 会继承，造成 SSL 验证失败+静默超时。