不能批量设timeout,必须分层配置:process-timeout和http-basic-timeout可写入composer.json的config段,http.timeout仅支持环境变量或全局config,且PHP底层default_socket_timeout也需同步调整。

直接结论:不能“批量”设 timeout,必须按作用域和层级分别配置 —— 项目级、全局级、环境变量级互不覆盖,且 http.timeout 还不能写进 composer.json 的 config 段。
为什么 composer.json 里写 "timeout": 600 没用
这个键根本不存在。Composer 从没认过 config.timeout。你看到的旧文档或 Stack Overflow 答案,大概率是 2015 年前的残留信息。真正起效的是三个独立参数:http.timeout、process-timeout、http-basic-timeout,它们控制不同阶段,也不能混着写。
-
process-timeout可以写进composer.json的config段,比如"process-timeout": 900 -
http-basic-timeout(Composer 2.2+)同样支持写进config段 -
http.timeout完全不支持 写进composer.json—— 它只能通过环境变量或全局 config 设置
process-timeout 和 http.timeout 到底管什么
这两个超时不是一回事,卡在不同环节,必须一起调:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
process-timeout控制子进程生命周期:比如unzip解压几百 MB 的 dist 包、git clone私有仓库、tar -xzf展开归档 —— 默认 300 秒,大项目很容易卡死在这一步 -
http.timeout控制 HTTPS 请求全周期:DNS 查询 + TLS 握手 + 首字节等待 + 整个 ZIP body 下载 —— 默认也才 300 秒,国内拉阿里镜像都可能超时 - 只改其中一个,另一层照样中断。比如你把
process-timeout设成 1800,但http.timeout还是 300,下载中途就会被 cURL 直接断掉,根本到不了解压阶段
怎么让所有项目都生效(全局配置 + 环境变量兜底)
全局配置靠 composer global config,但它不覆盖 http.timeout;环境变量优先级最高,适合 CI/CD 或临时调试:
- 设
process-timeout和http-basic-timeout全局生效:composer global config process-timeout 1800composer global config http-basic-timeout 300 -
http.timeout必须用环境变量:export COMPOSER_HTTP_TIMEOUT=1200(Linux/macOS)
Windows PowerShell:$env:COMPOSER_HTTP_TIMEOUT="1200" - 临时命令行覆盖最暴力:
COMPOSER_HTTP_TIMEOUT=1200 COMPOSER_PROCESS_TIMEOUT=2000 composer install
别忘了 PHP 底层 socket 超时这个隐藏开关
就算你把 http.timeout 设成 3600,如果 PHP CLI 的 default_socket_timeout 是默认 60 秒,cURL 在底层仍会在 60 秒后报 cURL error 28。检查方式:php -r "echo ini_get('default_socket_timeout');"
- 若输出是 60,就得同步调高:
php -d default_socket_timeout=1200 composer install - Docker 或 CI 中尤其容易忽略这点 —— 镜像里 PHP 默认值没改,光调 Composer 参数没用
- 这个值和
max_execution_time无关,它只影响 socket 层连接与读取,不控制 PHP 脚本执行逻辑

















