卡在Downloading https://时应调http.timeout,它控制DNS解析、TLS握手、首字节等待及整个body传输总时间,默认300秒(旧版60秒),弱网易触发cURL error 28;需同步调高PHP的default_socket_timeout。

Composer 卡死不是“等得不够久”,而是默认 timeout 阈值太低,且多层超时机制相互独立——必须分清是 HTTP 下载卡、子进程解压卡,还是 PHP 脚本执行卡,再对应调参。
卡在 Downloading https:// 时该调 http.timeout
这是 DNS 解析、TLS 握手、首字节等待、整个 ZIP 包 body 传输的总耗时。默认仅 300 秒(旧版甚至 60 秒),弱网下极易触发 cURL error 28。
- 项目级生效:
composer config http.timeout 1200(写入当前composer.json的config段) - 全局生效:
composer config -g http.timeout 1200(写入~/.composer/config.json) - 临时覆盖(最高优先级):
COMPOSER_HTTP_TIMEOUT=1200 composer install - ⚠️ 关键陷阱:若 PHP CLI 的
default_socket_timeout小于你设的http.timeout(常见值为 60),底层 cURL 会提前掐断连接——务必同步检查并调高:php -i | grep default_socket_timeout
卡在 unzip / git clone / post-install-cmd 时该调 process-timeout
错误信息里明确含 The process "" exceeded the timeout,说明是 unzip、git clone 或自定义脚本这类外部命令被杀,和 HTTP 完全无关。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 默认 300 秒,解压一个几百 MB 的 dist 包或拉私有 Git 仓库很容易超时
- 全局改:
composer config -g process-timeout 1800 - CI 环境更推荐环境变量:
COMPOSER_PROCESS_TIMEOUT=2000(部分 Composer 版本对它更敏感) - ⚠️ 关键陷阱:
--timeout=600是process-timeout的别名,但写法必须带等号:--timeout=600;--timeout 600(空格)会被静默忽略 - 设为 0 表示不限时,但不推荐——远程 Git 仓库彻底不可达时,会无限挂起
Composer 2.2+ 用户应额外调 http-basic-timeout
它只管单次 HTTP GET 的连接 + 读取(比如拉 packages.json 或 ZIP 的前几 KB),不涉及整个 body 传输。适合解决 TLS 握手慢、首字节延迟高等“卡在开头”的问题。
- 默认仅 60 秒,国内常见首字节 1–3 秒,极易触发
- 建议设为
300:composer config -g http-basic-timeout 300 - 临时用法:
composer install --http-basic-timeout=300 - ⚠️ 关键陷阱:这个参数 Composer 2.2+ 才支持,旧版本无效;且它和
http.timeout互不替代,只改一个大概率仍失败
自定义脚本(如 post-install-cmd)超时要动 PHP,不是 Composer
Composer 不控制脚本执行时间,那是 PHP 自己的 max_execution_time 在管。报错里出现 Maximum execution time of XXX seconds exceeded 就是它。
- 最稳方式:
php -d max_execution_time=0 composer install(0表示不限制) - 脚本内主动延长:
set_time_limit(1200),但必须在逻辑开始处调用,且只作用于当前 PHP 进程 - ⚠️ 关键陷阱:
set_time_limit()对proc_open()启动的子进程无效;若脚本里又调了git clone或npm install,还得靠process-timeout控制它们 - CI 中建议显式指定:
php -d max_execution_time=900 composer install --no-interaction
真正麻烦的从来不是“设多少秒”,而是中断后 vendor/ 里那些校验失败却没被清理的 ZIP 包、截断的 installed.json、卡死的临时目录——它们不会自己消失,也不会被重试自动覆盖。

















