Composer run-script本身不支持并发,仅串行执行scripts中定义的命令;真正并发需在PHP脚本内部实现,如用GuzzleHttp/Promise处理异步HTTP请求。

Composer run-script 本身不支持并发执行
你在 composer.json 的 scripts 字段里写再多命令,composer run-script a b c 也只会串行跑:等 a 完全退出(无论成功失败),才启动 b。Composer 不 fork 进程、不调度任务、不管理状态——它只是按顺序调用 shell 命令的薄包装器。
常见错误现象:
- 以为加了
&或nohup就能“后台并发”,结果脚本提前退出或 stdout/stderr 混乱 - 依赖
scripts顺序隐含逻辑(如先 build 再 deploy),但某步超时被 kill,后续脚本根本没机会运行 - 在 CI 中用
composer run-script test lint,想“并行提效”,实际只是徒增等待时间
真正可行的并发必须下沉到 PHP 脚本内部
想批量请求 API、并发处理文件、并行调用多个 CLI 工具,唯一可靠路径是:把并发逻辑写进你自己的 PHP 脚本里,再由 composer run-script 启动它。
推荐用 guzzlehttp/promises,不是因为它“高级”,而是它规避了手动 curl_multi 的典型陷阱:
-
curl_multi必须显式curl_close(),漏掉就内存泄漏;Promise\all()自动清理资源 - 超时控制分散在每个
curl_setopt(),而getAsync(..., ['timeout' => 5])统一声明 - 错误传播靠手写回调链,
Promise\settle()直接返回带state和value/reason的结构化数组
示例关键行(非完整脚本):
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
use GuzzleHttp\Client;
use GuzzleHttp\Promise;
$client = new Client();
$promises = [
'api1' => $client->getAsync('https://a.com'),
'api2' => $client->getAsync('https://b.com'),
];
$results = Promise\settle($promises)->wait(); // 阻塞直到全部完成
原子性操作只存在于 composer remove / install 级别
Composer 2.5+ 支持 composer remove --dev a/b c/d 这种空格分隔的批量删除,且是原子性的:要么全部卸载成功,要么全部回退,不会出现删一半卡住的状态。
但注意这和“并发”无关,它只是事务语义保障:
- 遇到
Package is required by another package报错,说明该包被其他已装包(如phpstan/phpstan)硬依赖,不能靠remove强删,得先composer depends a/b查清依赖链 -
composer update --refresh是唯一强制刷新元数据的原子操作,它会丢弃本地~/.composer/cache/repo/下所有旧索引,直连 packagist 重拉packages.json - 别信
composer clear-cache能解决 update 拉不到新版的问题——它默认不碰 repo 缓存,必须手动删或用--refresh
并发脚本最常崩在边界控制,不是逻辑本身
一个 fetch.php 在本地跑通 10 次不等于上生产就稳。真实崩溃点往往藏在:
- 没设
default_timeout,某个 API 偶发卡住 30 秒,整个 CLI 进程 hang 死 - 用
Promise\all()但没做try/catch,任一 promisereject就导致未捕获异常终止进程 - 并发数设成 50,但目标服务限流 10 QPS,大量 429 响应没重试逻辑,直接失败
- 脚本里用了
file_get_contents()或exec()这类同步阻塞调用,Promise 并发效果归零
PHP CLI 是单进程事件循环,Promise 并发 ≠ 多线程,它靠 stream_select() 轮询 I/O 就绪状态。一旦混入同步操作,整个轮询就被拖住。这点容易被忽略。

















