Composer脚本不支持负载调度,因其仅为同步单进程CLI钩子;需改用supervisor、Celery、Laravel Horizon等专业调度工具。

Composer 脚本本身不支持负载调度(如并发控制、队列分发、优先级调度),它只是顺序执行命令的轻量钩子机制。想在 Composer 脚本里做“负载调度”,本质是误用了它的定位——该交给专门的任务调度器或进程管理工具来干。
为什么 composer run-script 不能做负载调度
Composer 的 run-script 是同步、单进程、无状态的 CLI 工具链入口,所有脚本都在当前 shell 进程中线性执行:
-
scripts中定义的数组项按顺序逐个 fork 子进程运行,不支持并行、限流、重试或超时控制 - 没有内置队列、工作进程池、心跳检测或失败转移能力
- 脚本退出码只用于判断成败,无法反馈“排队中”“被抢占”“降级执行”等调度语义
- 一旦
composer install或run-script启动,整个流程就绑定在当前终端会话,无法被外部调度器接管
真正需要负载调度时,该用什么替代
当你的部署、构建或数据预热任务开始出现资源争抢、执行超时、或需按环境/优先级分流时,应脱离 Composer 脚本,改用专业工具:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 本地开发或 CI 环境:用
make+concurrent(GNU Parallel)控制并发数,例如parallel -j4 {} ::: "php migrate" "php import:users" "php import:posts" - 生产级任务调度:接入
supervisor(进程保活)、celery(Python 生态)、或 PHP 原生方案如spiral/jobs/laravel/horizon - CI/CD 流水线内:直接用 GitHub Actions 的
strategy.matrix或 GitLab CI 的parallel关键字分片,比在 Composer 里硬塞逻辑更可靠 - 若仍想保留
composer run-script入口:让它只负责“提交任务”,例如调用php artisan queue:push --job=DeployJob --env=prod,把实际执行交给队列驱动
强行在 scripts 里模拟调度的坑
有人试图用 sleep、ps aux | grep 或临时文件锁来“调度”,结果往往更糟:
- Linux 下
ps解析不可靠,不同发行版输出字段不一致,grep php可能误杀其他项目进程 - 文件锁在 NFS 或容器挂载卷上容易失效,且没超时自动释放机制
- 用
exec php script.php &启后台进程后,Composer 会立刻认为脚本结束,导致后续步骤提前执行,或父进程退出后子进程被 SIGTERM 终止 - 所有这些逻辑都绕过了 Composer 的错误传播机制——某个子任务失败,
run-script却返回 0
真正的负载调度必须有可观测性、可中断性、和状态持久化。Composer 脚本连 stdout 都默认截断,更别说记录任务耗时或重试次数了。别把它当任务队列用,该换工具时就换。

















