Composer 的 event-subscriber 是第三方插件 mouf/event-subscriber 提供的扩展机制，用于结构化监听 install/update 生命周期事件；它不是 Composer 官方功能，也不支持直接在 composer.json 中配置，需通过 extra 字段注册实现 EventSubscriberInterface 的类。
Composer 的 event-subscriber 是什么，不是什么
它不是 Composer 自带的官方功能，也不是 composer.json 里直接支持的字段；它是第三方插件 event-subscriber 提供的扩展机制，用于在 Composer 安装/更新过程中监听并响应生命周期事件（比如 post-install-cmd、post-update-cmd），但比原生脚本更结构化、可复用。
如果你看到文档里写 “实现 EventSubscriberInterface”，那基本是在用这个插件，而不是 Composer 原生能力。
怎么安装和注册 event-subscriber 插件
先确认你用的是支持插件的 Composer 版本（2.2+ 推荐，1.x 需开启插件支持）；然后执行：
composer require --dev "hirak/prestissimo:^0.4" # 不是它，别装错 composer require --dev "mouf/annotations" # 也不是 # 正确命令： composer require --dev "mouf/event-subscriber"
接着在 composer.json 中声明你的订阅类：
{
"autoload": {
"psr-4": { "App\Events\": "src/Events/" }
},
"extra": {
"mouf/event-subscriber": {
"subscribers": [
"App\Events\MyInstallSubscriber"
]
}
}
}
-
"mouf/event-subscriber"这个 key 必须完全匹配，大小写敏感 - 类必须存在且可自动加载，否则 Composer 会静默跳过（不报错，但事件不触发）
- 插件只在
install和update时生效，dump-autoload或require单个包不会触发
写一个有效的 EventSubscriber 类要注意什么
你的类要实现 MoufComposerEventSubscriberInterface，并返回事件名与回调方法的映射。不能只写个普通类，也不能用 __invoke 或静态方法代替。
namespace AppEvents;
<p>use MoufComposerEventSubscriberInterface;
use ComposerScriptEvent;</p><p>class MyInstallSubscriber implements EventSubscriberInterface
{
public static function getSubscribedEvents(): array
{
return [
'post-install-cmd' => 'onPostInstall',
'post-update-cmd' => 'onPostUpdate',
];
}</p><pre class="brush:php;toolbar:false;">public function onPostInstall(Event $event): void
{
$io = $event->getIO();
$io->write('✅ Install finished, clearing cache...');
// 注意：这里不能直接调用 Laravel 的 Artisan::call()，因为容器未启动
}
public function onPostUpdate(Event $event): void
{
// 同上，$event->getComposer() 可取 composer 实例，但操作受限
}}
- 方法名必须是实例方法（不能 static），且参数类型为
ComposerScriptEvent - 不要在回调里执行耗时 I/O（如远程请求），它会阻塞整个 Composer 流程
- 无法访问 Laravel/Symfony 等框架运行时上下文，仅能用 Composer 自带的
$event->getIO()、$event->getComposer()
为什么事件没触发？常见静默失败点
这个插件最容易让人困惑的地方是——它失败时不报错，只是“没反应”。排查优先看这几点：
-
composer.json里"extra"下的"mouf/event-subscriber"键名拼错，或缩进错误（JSON 格式非法会导致整个 extra 被忽略） - 类文件没被
autoload覆盖，composer dump-autoload后仍提示Class not found—— 但插件不会告诉你 - 你在
require一个新包时期望触发post-install-cmd，但实际上只有首次install或全量update才走完整流程；单包require默认走的是install子流程，不一定触发所有事件 - 使用了 Composer 2.5+ 的
--no-plugins模式（CI 环境常见），插件被强制禁用
真要调试，唯一可靠方式是临时在 vendor/mouf/event-subscriber/src/EventSubscriberPlugin.php 里加 file_put_contents('/tmp/debug.log', ...)，插件本身没有日志开关。
