--timeout=参数必须带等号,不写等号(如--timeout 1800)会静默失效,正确写法是--timeout=1800;它仅控制当前命令整体生命周期,单位秒,建议设为1200起,且需配合--http-basic-timeout=(Composer 2.2+)共同调整。

composer install/update --timeout=参数必须带等号
不写等号会静默失效,比如 composer update --timeout 1800 看似合理,实际完全不生效,Composer 仍按默认 300 秒中断。正确写法是 composer update --timeout=1800,单位为秒,建议从 1200(20 分钟)起步,大项目可设到 3600(1 小时)。
该参数只影响当前命令,适合 CI 脚本临时救急或本地调试。注意它不是 --process-timeout——后者根本不存在,写了会被忽略。
process-timeout 和 http-basic-timeout 要一起调
仅调 process-timeout 不够,因为 Composer 内部有两层超时:整体生命周期(process-timeout)和单次 HTTP 请求(http-basic-timeout)。后者默认仅 60 秒,下载一个 100MB 的 dist 包很容易触发。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- Composer 2.2+ 才支持
--http-basic-timeout=300,旧版本只能靠换镜像硬扛 - 全局永久设置:
composer config -g process-timeout 3600+composer config -g http-basic-timeout 300 - 项目级更稳妥:在
composer.json的config段里加这两项,能随代码提交、被 CI 读取
超时只是表象,内存和镜像才是关键瓶颈
很多“超时”其实是内存不足导致的假象:PHP 在解析复杂依赖树或解压大包时 fork failed - Cannot allocate memory,报错却显示 The process timed out。此时调高 timeout 只会让失败来得更慢。
- 检查
memory_limit是否 ≥ 1.5G,CI 容器尤其要确认未被 cgroup 限制 - 国内用户不切镜像源,
--timeout=7200也救不了连不上 packagist.org 的情况 - 执行
composer config -g repo.packagist false关闭 fallback,再配阿里云镜像:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
Git 类依赖会让 timeout 更难预测
如果 composer.json 里用了 "type": "vcs" 或直接写 git@ / https://github.com/ 地址,每次 git clone 都计入总 process-timeout,不是单次独立计时。一次 update 可能触发十几次 clone,累积起来轻松突破阈值。
验证方式很简单:单独运行 git clone https://xxx 看是否卡在 SSH 认证、代理或 DNS 解析。这类问题调 timeout 没用,得先解决 Git 层连接稳定性。

















