Composer不支持在composer.json中直接通过scripts字段声明EventSubscriber类；正确做法是使用第三方插件mouf/event-subscriber，在extra字段中注册实现EventSubscriberInterface的类，如"mouf/event-subscriber": {"subscribers": ["AppEventsMyInstallSubscriber"]}，且需确保类可自动加载。
如何在 composer.json 中声明事件订阅者
Composer 的生命周期事件（如 pre-install-cmd、post-autoload-dump）本身不支持直接写脚本命令，必须通过「事件订阅者」——即一个实现了 EventSubscriberInterface 的 PHP 类——来响应。关键前提是：这个类必须能被 Composer 自动加载，且其 getSubscribedEvents() 方法返回明确的事件映射。
在 composer.json 中，你需要两处配置：
-
"autoload": { "psr-4": { "My\Script\": "src/" } }—— 确保类可被自动加载（运行composer dump-autoload后生效） -
"scripts": { "My\Script\BuildListener" }—— 注意：这里不是调用函数，而是把类名作为「脚本值」注册为监听器（Composer 会自动实例化并检查接口）
如果类名拼错、未 autoload、或没实现 EventSubscriberInterface，Composer 运行时不会报错，但事件完全静默失效——这是最常被忽略的调试盲区。
事件订阅者类必须满足哪些接口契约
Composer 不接受任意 callable，只认 ComposerEventDispatcherEventSubscriberInterface。它强制要求一个静态方法 getSubscribedEvents()，返回形如 ['post-autoload-dump' => 'onPostAutoloadDump'] 的数组。
对应事件处理方法（如 onPostAutoloadDump）接收一个 Event 对象（具体子类取决于事件类型，例如 CommandEvent 或 PackageEvent），**不能带额外参数，不能是 static 方法，也不能返回值**。
常见错误现象：
- 方法签名写成
public static function onPostAutoloadDump(Event $event, $extra = null)→ 直接被跳过，无提示 - 返回
return true;→ 不影响执行，但违背契约，后续升级可能触发警告 - 类放在
vendor/下却未声明 autoload → 类找不到，Composer 沉默跳过该订阅者
推荐做法：用 IDE 或 php -l 验证语法后，手动触发一次对应命令（如 composer dump-autoload），再在处理方法里加 file_put_contents('debug.log', 'hit', FILE_APPEND); 确认是否真正进入。
哪些事件适合挂载外部脚本，哪些不适合
不是所有事件都适合执行耗时或有副作用的操作。例如：
-
pre-install-cmd和pre-update-cmd：适合做依赖检查、环境预检；但**不能依赖vendor/autoload.php**（此时 autoloader 尚未生成） -
post-autoload-dump：autoloader 已就绪，适合生成代理类、扫描注解；但注意此事件在composer install和composer dump-autoload时都会触发，逻辑需幂等 -
post-package-install：每个包安装完都触发一次，若脚本含 I/O 或网络请求，会显著拖慢整体安装速度，慎用
如果你只是想跑一个 shell 脚本（如构建前端资源），更轻量的做法其实是用普通脚本钩子："scripts": { "post-install-cmd": "./build-assets.sh" }，而非硬套事件订阅者——后者仅在需要访问 Composer 内部对象（如 $event->getComposer() 或 $event->getIO()）时才真正必要。
调试事件订阅者不触发的三个关键检查点
当写了订阅者却毫无反应，优先查这三项：
- 运行
composer show --scripts，确认你的类名出现在scripts列表中（格式必须严格匹配，大小写敏感） - 执行
composer dump-autoload -v，观察输出末尾是否有Adding script MyScriptBuildListener类似日志（没有则说明注册失败） - 在订阅者构造函数里加
throw new Exception('ctor hit');，再运行触发事件的命令——如果没抛异常，说明类根本没被实例化，问题一定出在注册或 autoload 阶段
Composer 的事件系统本身不提供日志开关，也没有类似 Laravel 的 php artisan event:list 工具，验证全靠手动埋点和输出观察。一旦跨项目复用订阅者，路径、命名空间、autoload 配置稍有偏差，就会彻底失联。
