卡在Downloading https://时应调http-basic-timeout(Composer 2.2+)或http.timeout(旧版),控制DNS解析、TLS握手、首字节等待及body传输总时间,默认值过短易超时,须同步调高PHP的default_socket_timeout。

必须同时调高 process-timeout 和 http.timeout(或 http-basic-timeout),只改一个大概率仍失败。
卡在 Downloading https:// 时该调哪个 timeout
这是 HTTP 请求阶段卡住,比如拉 packages.json、下载 ZIP 包,错误里常带 cURL error 28 或反复 retry 后失败。它不看 process-timeout,只认 http.timeout(Composer 2.x)或 http-basic-timeout(2.2+)。
-
http.timeout控制 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输的总时间,默认仅 300 秒,弱网下极易触发 -
http-basic-timeout是更细粒度的单次 HTTP 请求读取超时(如下载一个 ZIP),默认 60 秒,2.2+ 才支持 - PHP 的
default_socket_timeout必须 ≥ 你设的http.timeout,否则会被提前掐断;运行php -i | grep default_socket_timeout查,若为 60 就得同步改高 - 项目级最稳:运行
composer config http.timeout 600,写入当前composer.json的config段,可提交、可复现
报 The process timed out 错误该调哪个 timeout
这是子进程执行太久被杀,比如 git clone、unzip、跑 post-install-cmd 脚本。错误里一定含 [RuntimeException] The process "" exceeded the timeout,加 -vvv 可看到最后那条命令。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
process-timeout控制单个外部命令最大执行时间,默认 300 秒,和 HTTP 完全无关 - 全局改:运行
composer config -g process-timeout 1800,写入~/.composer/config.json - 临时覆盖优先级最高:用
COMPOSER_PROCESS_TIMEOUT=1800 composer install,适合 CI 调试 - 值设为 0 表示禁用超时,但可能卡死无响应;调试建议先设 600,确认能走通再调高
命令行参数怎么一次配齐
临时调试最直接,不用改配置文件,也避免污染全局或项目设置。
- Composer 2.2+ 推荐组合:
composer install --timeout=1200 --http-basic-timeout=300 - 旧版本或不确定版本时用:
COMPOSER_HTTP_TIMEOUT=1200 COMPOSER_PROCESS_TIMEOUT=1200 composer install - 注意:
--timeout参数在部分版本中实际等效于process-timeout,不是 HTTP 超时,别被名字误导 - 如果用了
php -d启动,记得补上memory_limit=-1,避免 OOM 中断
真正容易被忽略的是 PHP 自身的 default_socket_timeout 和镜像源切换——超时调再高,DNS 解析慢或连不上 packagist.org,照样卡住。换阿里云镜像(composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/)比单纯加 timeout 有效得多。

















