post-install-cmd脚本超时由PHP的max_execution_time控制,非Composer配置项;可通过php -d max_execution_time=0 composer install临时禁用,或在脚本开头调用set_time_limit()动态延长,同时需排查--no-interaction缺失、CI系统级timeout及memory_limit不足等隐性阻塞。

post-install-cmd 脚本超时由 PHP 控制,不是 Composer 配置项
Composer 的 post-install-cmd、post-update-cmd 等脚本是直接由 PHP 进程执行的,超时机制完全来自 PHP 自身的 max_execution_time,和 process-timeout 或 http.timeout 无关。你在 composer.json 的 config 段写 "timeout": 0 或 "process-timeout": 0,对这类脚本完全无效。
常见错误现象包括:
- 脚本中途静默退出,无报错或只显示
Script xxx handling the xxx event returned with error code 1 - 日志里出现
PHP Fatal error: Maximum execution time of 300 seconds exceeded -
composer install -v显示卡在某条命令(如php artisan config:cache)后不再推进
临时生效:用 php -d max_execution_time=0 启动 Composer
这是最直接、无需改代码、兼容所有 Composer 版本的方式。它让整个 Composer 进程(含所有子脚本)运行时的 PHP 执行时间不受限。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 命令必须带
-d参数,且写在composer前面:php -d max_execution_time=0 composer install - 设为
0表示禁用限制;也可设具体秒数,如php -d max_execution_time=900 composer install - CI/CD 中推荐显式指定,避免依赖系统默认值(很多 CI 镜像默认是 300 秒)
- 注意:若 PHP 的
max_execution_time被disable_functions禁用,该参数会失效,需检查php -i | grep disable_functions
长期生效:在脚本内部调 set_time_limit()
适合你控制脚本源码的情况(比如自定义类或独立 PHP 入口),比全局改 PHP 更精准,但必须满足两个硬性条件:位置要早、作用域要对。
- 必须放在脚本逻辑最开头,例如在
MyBuildScript::run()的第一行就调set_time_limit(1200) - 不能写在函数体外或类定义里——CLI 模式下只有被执行到的代码才生效
- 如果脚本是通过
php artisan或其他封装命令间接触发,而你无法修改其入口文件,则此法无效 - 设为
0可禁用限制,但需确认运行环境允许(部分容器或共享主机禁止)
容易被忽略的交互阻塞和系统级截断
很多“超时”根本不是时间问题,而是卡在等待输入或被更高层限制提前杀死。
- 加
--no-interaction:避免php artisan key:generate等命令因 stdin 不可用而挂起 - 检查 CI runner 系统级 timeout:GitHub Actions 默认 6 小时,但自建 runner 可能设了 20 分钟硬限制,比 PHP 超时更早触发
- 确认没被外层
timeout命令包裹:Docker 容器中运行时,docker run --stop-timeout或宿主timeout 600 composer install会直接 kill 进程,Composer 来不及响应 - memory_limit 不足也会表现为“假性超时”:Composer 解析锁文件或执行
dump-autoload时 OOM,进程被系统 SIGKILL,日志里看不到超时字样

















