scripts中直接写composer install会卡住,因Composer默认不启用shell模式,且install命令不支持嵌套调用;正确做法是显式用php composer.phar启动新进程或通过Event对象调用支持的命令类。

scripts 里直接写 composer install 会卡住
因为 composer 在 scripts 中默认不走 shell,而是调用内部命令处理器,遇到带空格或管道的命令会失败,甚至静默退出。你写 "post-install-cmd": "composer install",实际什么都不会发生——它不是启动新进程,而是尝试在当前上下文中“复用”命令逻辑,但 install 不支持被嵌套调用。
正确做法是显式启用 shell 模式:
- 用
php composer.phar或composer命令字面量启动新进程(确保 PATH 可达) - Windows 下注意路径分隔符和 .bat/.exe 优先级,推荐统一用
php composer.phar - 避免在
scripts中递归触发同类型事件(比如post-install-cmd里再跑composer install),可能造成死循环
想复用 Composer 内置命令逻辑,得用 Composer\Script\Event
如果你真需要在 PHP 脚本里调用 dump-autoload 或 run-script 这类行为,而不是起子进程,就得进到 Composer 的事件对象里操作。它的核心是 $event->getComposer() 返回实例,再通过 getCommand() 或手动 new 一个命令类来执行。
例如在自定义脚本中触发自动加载重生成:
use Composer\Script\Event;
use Composer\Command\DumpAutoloadCommand;
<p>public static function myPostUpdate(Event $event) {
$command = new DumpAutoloadCommand();
$command->run($event->getInput(), $event->getOutput());
}注意:DumpAutoloadCommand 是公开类,但像 InstallCommand 这类主流程命令基本不支持外部直接 run,会缺 context 或 io 绑定。
工作流任务拆解与模型编排技能。使用场景:(1) 收到复杂工作任务需要拆解为可执行步骤,(2) 需要为不同步骤选择最合适的模型,(3) 需要跟踪工作流进度和模型使用情况,(4) 长时间任务卡住需要问题诊断和解决方案。
run-script 嵌套调用时参数传递容易丢
你在 scripts 里写 "build": "composer run-script build-js && composer run-script build-css" 看似没问题,但一旦某个子 script 定义了 --no-interaction 或接收自定义参数,父级传入的 -- 后参数不会自动透传。
-
composer run-script build-js -- --watch只会传给最外层run-script,不会进到build-js的$args - 解决方法:在目标 script 的闭包函数里用
$event->getArguments()显式读取,并手动转发 - 别依赖
$argv,Composer 的 script 执行环境不保证原始 CLI 参数可见
CI/CD 中混用全局和项目级 Composer 可能导致行为不一致
很多 CI 配置习惯先 composer global require ...,再在项目里 composer run-script。问题在于:全局插件注册的命令(比如 composer normalize)在项目 scripts 中不可见,除非你明确用 php composer.phar 并确保 global bin 目录在 PATH 中。
更稳的做法:
- CI 中统一用
php composer.phar install --no-interaction,避免全局状态干扰 - 所有 scripts 都假设运行在 clean vendor 环境下,不依赖本地全局安装的插件
- 如果必须用插件命令,把它写进
require-dev,并用vendor/bin/composer-normalize这种绝对路径调用
真正麻烦的是 autoload 时机——scripts 运行时,vendor/autoload.php 可能还没生成,所以任何依赖自动加载的自定义 PHP 脚本,都得放在 post-autoload-dump 之后,或者自己 require 'vendor/autoload.php' 前加存在性判断。

















