Composer如何设置timeout参数？新手快速上手指南-composer-PHP中文网

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

composer如何设置timeout参数？新手快速上手指南

Composer 没有全局统一的 timeout 参数，你看到的 --timeout 实际只控制整个命令生命周期（process-timeout），而下载卡住时真正要调的是 http.timeout 或 --http-basic-timeout——搞混这两者，加再多秒也没用。

composer install/update 卡在 Downloading https:// 时该改哪个？

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

http.timeout 控制 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输总时间，默认仅 300 秒，弱网下极易触发
项目级最稳：运行 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 错误该调哪一项？

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

Discussion Composer

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

下载

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 或命令行参数 --timeout=1800（注意：Composer 2.2+ 才支持 --http-basic-timeout 单独调 HTTP 层超时）
错误写法：composer install --timeout 600（少等号）会静默忽略，必须带 =

自定义脚本（如 post-install-cmd）超时怎么办？

Composer 脚本由 PHP 进程执行，超时由 PHP 自身机制控制，不是 Composer 配置项。你在 composer.json 的 "config": {"timeout": 600} 是无效的。

最常用方式：php -d max_execution_time=0 composer install（0 表示不限制；也可设为 600）
CI/CD 中建议显式指定：php -d max_execution_time=900 composer install --no-interaction
若在脚本内部用 set_time_limit()，必须确保它在执行早期就触发，否则可能被后续逻辑覆盖
注意：PHP CLI 模式下若 max_execution_time 被 disable_functions 禁用，则 set_time_limit() 直接报错

真正卡住时，别只盯着 timeout——内存不足会导致 OOM，表现和超时几乎一样；用了 git 仓库（"type": "vcs"）每次 git clone 都计入总超时；国内用户不切镜像源，--timeout=3600 也救不了连不上 packagist.org 的情况。先切阿里云镜像、禁用回源，再调 timeout，才是正解。