process-timeout是Composer控制子进程执行时限的核心配置,默认300秒,超时即杀进程并报“The process timed out”;需同步调整http-basic-timeout(默认60秒)以解决下载阶段超时,两者独立生效,必须共调才有效。

process-timeout 是 Composer 控制整个命令生命周期的核心配置项,默认 300 秒(5 分钟)。它不是 PHP 的 max_execution_time,而是 Composer 自己用 proc_open() 启动子进程时施加的硬性限制——超时后直接杀掉进程,报错 The process timed out。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
为什么改了 timeout 还失败?两个超时要一起调
process-timeout 管总耗时,http-basic-timeout 管单次 HTTP 请求(比如下载一个 zip 包)。只调高前者,遇到慢镜像或大包仍会卡在 downloading 阶段报 Connection timed out。
- process-timeout 默认 300,影响 update/install 全流程(含依赖解析、git clone、解压)
- http-basic-timeout 默认 60,仅 Composer 2.2+ 支持;旧版本只能靠换源或加 --timeout 硬扛
- 两者独立生效,必须同时调整才稳妥
临时调试推荐这样写:composer update --timeout=1200 --http-basic-timeout=300
注意:--http-basic-timeout 在 2.2 以下版本无效,此时可改用环境变量 COMPOSER_PROCESS_TIMEOUT=1200
永久配置该写哪?全局优先,项目级慎用
全局配置写入~/.composer/config.json,一劳永逸;项目级配置写入当前目录的 composer.json 的 config 字段,适合团队强制约束。
- 全局生效:composer config -g process-timeout 1800 和 composer config -g http-basic-timeout 300
- 项目级生效(不带 -g):composer config process-timeout 1200
- 验证是否生效:composer config process-timeout(有输出即已设置)
- 值设为 0 表示不限时,但不建议——网络卡死时可能挂住无响应
CI/CD 或 Docker 中容易漏的关键点
Docker 容器里执行composer install 失败,未必是 Composer 配置问题:
- 检查是否被 docker run --stop-timeout 或外层 timeout 命令提前终止——Composer 根本感知不到这一层
- CI 环境中 COMPOSER_HOME 未指定时,每次构建都重置配置,必须显式设置并写入缓存
- memory_limit 不足也会触发超时假象(尤其 update 解析锁文件阶段),建议 CLI 模式设为 -1 或 ≥1.5G
- 使用 git 类仓库时,每次 git clone 或 git checkout 都计入 process-timeout 总时长,不是单次计时
比调 timeout 更有效的三件事
单纯延长超时只是“等得更久”,不能解决根本瓶颈: - 切国内镜像源:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 关闭 packagist.org 回源(防 fallback 拖慢):composer config -g repo.packagist false
- 跳过 autoload 生成再手动优化:composer install --no-autoloader → composer dump-autoload --optimize真正卡住的地方往往不在超时参数本身,而在镜像稳定性、VCS 仓库响应、autoload 扫描深度或容器资源限制。调 timeout 是兜底手段,不是第一选择。

















