Composer install/update卡住主因是子进程超时(默认300秒)或PHP主进程max_execution_time限制,而非单纯网络慢;需分别通过COMPOSER_PROCESS_TIMEOUT环境变量和php -d max_execution_time调整。

composer install 或 update 为什么会卡住
Composer 命令卡住,常见原因不是网络慢,而是 PHP 进程被系统或容器限制了执行时间(比如 max_execution_time 超时),或者 Composer 自身在解析依赖、下载包、解压时遇到阻塞。它本身没有 --timeout 这类全局参数,但有对应机制可干预。
用 COMPOSER_PROCESS_TIMEOUT 环境变量控制超时
Composer 内部对子进程(如 Git 克隆、zip 解压、脚本执行)使用独立超时逻辑,默认是 300 秒(5 分钟)。这个值由环境变量 COMPOSER_PROCESS_TIMEOUT 控制,不是命令行参数,也不能写进 composer.json。
- 临时生效:运行前设置,例如
COMPOSER_PROCESS_TIMEOUT=600 composer install - 永久生效(Linux/macOS):加到 shell 配置里,如
export COMPOSER_PROCESS_TIMEOUT=1200 - Docker 中:在
docker run里用-e COMPOSER_PROCESS_TIMEOUT=300传入 - 注意:该变量只影响子进程(Git、unzip、scripts),不影响 Composer 主流程的 PHP 执行时间
PHP 的 max_execution_time 也会中断 Composer
如果 Composer 在解析依赖树或生成 autoloader 时耗时过长,而 PHP 的 max_execution_time 设得太小(比如 CLI 模式下默认是 0,但某些 Docker 镜像或托管环境会设为 30 或 60),就会直接报 Fatal error: Maximum execution time of X seconds exceeded。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 检查当前值:
php -r "echo ini_get('max_execution_time');" - 临时绕过:
php -d max_execution_time=0 /usr/bin/composer install - 不要盲目设为 0:生产环境建议设为 600~1800,避免无限 hang 住
- 这个设置和
COMPOSER_PROCESS_TIMEOUT是两层机制,必须同时检查
哪些场景容易触发超时,该怎么调
不是所有项目都需要改超时。以下情况才值得调整:
- 私有 Packagist 源响应慢,或用了大量 VCS 包(
"type": "vcs")且 Git 仓库大 → 提高COMPOSER_PROCESS_TIMEOUT - 项目含几十个自定义 scripts,且某个脚本做了耗时操作(如生成静态资源)→ 单独给该 script 加
timeout(需 Composer 2.2+):"scripts": { "build": { "script": "php build.php", "timeout": 1200 } } - CI 环境内存低导致解压 zip 缓慢 → 不单是时间问题,要配合
COMPOSER_MEMORY_LIMIT=-1和调高COMPOSER_PROCESS_TIMEOUT - Windows 上用 Git Bash 执行
composer update卡在 “Loading composer repositories” → 很可能是 Git 子进程被 Windows 防火墙拦截,超时是表象,得查网络策略
超时参数不是万能解药;真正慢的根源常在源配置、网络代理、磁盘 I/O 或 packagist.org 限速。先用 composer install -vvv 看卡在哪一步,再决定调哪个值。










