卡在Downloading应改http.timeout,报子进程超时才改process-timeout;项目级永久设置用composer config process-timeout 1200和composer config http.timeout 600写入composer.json,二者互不干扰且必须匹配PHP default_socket_timeout。

composer install/update 卡住时该改哪个 timeout 参数
Composer 有两个关键超时参数,互不干扰,必须分清场景再改:process-timeout 和 http.timeout(Composer 2.x)或 http-basic-timeout(2.2+)。卡在 Downloading https:// 是 HTTP 层问题,只看 http.timeout;报 [RuntimeException] The process "" exceeded the timeout 才是 process-timeout 触发的子进程超时。
怎么永久设置 project 级的 timeout
项目级配置最可控,改完可提交、可复现,适合团队协作:
- 运行
composer config process-timeout 1200,写入当前composer.json的config段,控制git clone、unzip等子进程最大执行时间(单位秒) - 运行
composer config http.timeout 600,同样写入composer.json,控制所有 HTTP 请求总耗时(DNS + TLS + 首字节 + body 传输) - 若用 Composer 2.2+,还可加
composer config http-basic-timeout 300,单独调单次 HTTP 连接/读取时限(旧版本不支持) - 改完后用
composer config process-timeout或composer config http.timeout验证是否生效(有输出即已写入)
全局设置和临时覆盖哪个更可靠
全局配置影响所有项目,适合统一环境(如 CI runner 或本地开发机);临时覆盖优先级最高,但仅限单次命令:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 全局设
process-timeout:运行composer config -g process-timeout 1800 - 全局设
http.timeout:运行composer config -g http.timeout 600 - 临时覆盖(推荐 CI 调试):设环境变量
COMPOSER_PROCESS_TIMEOUT=2000和COMPOSER_HTTP_TIMEOUT=1200,再跑composer install -
注意:PHP 的
default_socket_timeout(查法:php -i | grep default_socket_timeout)若低于你设的http.timeout,会提前掐断连接——常见默认值是 60,务必同步调高
为什么只改 timeout 还是失败
单纯拉长超时只是兜底,不是提速。真正卡住往往因为:
- 没切国内镜像源,还在直连
packagist.org(推荐阿里:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/) - 未禁用 packagist.org 回源,导致 fallback 重试拖慢整体流程(
composer config -g repo.packagist false) - 内存不足,尤其
composer update解析锁文件阶段,memory_limit建议 ≥ 1.5G - 用了私有 Git 仓库,但镜像不代理 VCS,
git clone仍走原地址——这种场景得单独优化 SSH/HTTPS 连接或加git config --global http.postBuffer
最常被忽略的是 PHP 底层 socket 超时和镜像回源逻辑,这两个不处理,timeout 设再大也白搭。

















