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

直接调 http.timeout 和 process-timeout,只改一个基本没用——前者管 HTTPS 下载(拉 ZIP、packages.json),后者管 unzip、git clone 这类子进程,两者默认都是 300 秒,在国内弱网或大包场景下必然失败。
卡在 Downloading https:// 该调哪个参数
这是 HTTP 请求生命周期超时,错误里常带 cURL error 28 或反复 retry 后失败。它只认 http.timeout(Composer 2.x)或 http-basic-timeout(2.2+),不看 process-timeout。
-
http.timeout控制 DNS 解析 + TLS 握手 + 首字节等待 + 整个 body 传输总时间,默认仅 300 秒;建议设为600或1200 -
http-basic-timeout(Composer 2.2+)更细粒度:只管单次 GET 的连接与读取(比如拉 packages.json 头几 KB),默认仅 60 秒,建议设为300 - 项目级生效:
composer config http.timeout 600(写入当前composer.json的config段) - 全局生效:
composer config -g http-basic-timeout 300 - 临时覆盖优先级最高:
COMPOSER_HTTP_TIMEOUT=1200 composer install
卡在 unzip / git clone / Executing command 该调哪个
错误里一定含 [RuntimeException] The process "" exceeded the timeout,加 -vvv 能看到最后执行的命令。这是子进程被杀,和 HTTP 完全无关。
-
process-timeout控制单个外部命令最大执行时间,默认 300 秒;解压几百 MB 的 dist 包很容易卡在这一步 - 建议设为
1200~1800;设为0表示禁用,但可能卡死无响应 - 项目级改法:在
composer.json顶层"config"段加"process-timeout": 1200 - 全局改法:
composer config -g process-timeout 1800 - 临时覆盖:
COMPOSER_PROCESS_TIMEOUT=2000 composer install
为什么改了 config.timeout 没效果
config.timeout 是无效字段——Composer 根本不认这个 key。你看到的旧文档或教程写的这个配置,早已被废弃多年。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 真正起效的是三个独立参数:
http.timeout、process-timeout、http-basic-timeout -
http.timeout不能通过写进composer.json的config段来设置(项目级只能用composer config http.timeout N命令写入) -
process-timeout和http-basic-timeout可以写进composer.json,但http.timeout不行 - PHP 底层
default_socket_timeout必须 ≥ 你设的http.timeout,否则 cURL 会在底层提前掐断;查法:php -i | grep default_socket_timeout,常见值是 60,务必同步调高
换源比加 timeout 更治本
80% 的“超时”本质是源不稳定,不是网速慢。阿里云镜像能绕过 DNS 污染、TLS 握手抖动和国外源响应延迟。
- 配置命令:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/(注意末尾斜杠不能少) - 必须禁用 fallback:
composer config -g repo.packagist false,否则 Composer 自动回退到官方源拖慢流程 - 换源后必须清缓存:
composer clear-cache,否则仍可能从损坏的本地缓存读取 - 验证是否生效:
composer config -g repo.packagist应输出完整 JSON,且composer install --dry-run中下载链接要变成mirrors.aliyun.com - 注意:
"type": "git"的包会绕过镜像直连 GitHub,此时必须靠process-timeout+ Git 自身超时控制
真正麻烦的从来不是“等多久”,而是中断后 vendor/ 里那些看似完整、实则校验失败的包文件——它们不会自己消失,也不会被 --force 清掉,得手动删缓存、删 autoload.php、再重装。










