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)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “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 验证失败+静默超时。

















