Composer只支持预定义事件名（如pre-install-cmd、post-autoload-dump等），不支持自定义事件；脚本值可为字符串（执行shell命令）或数组（顺序执行PHP回调或命令）；PHP回调需为静态方法且类必须可自动加载。
Composer 的脚本事件监听器不是“注册式钩子”，而是通过 scripts 字段在 composer.json 中声明对标准事件的响应行为——它不支持任意自定义事件名，所有可监听的事件都由 Composer 内部预定义。
哪些事件名是合法的？
Composer 只识别固定的一组事件名（如 pre-install-cmd、post-autoload-dump 等），不能随便写个 my-custom-event 就触发。这些事件分两类：
-
命令生命周期事件：如
pre-update-cmd、post-install-cmd，对应composer install或composer update执行前/后 -
核心流程事件：如
post-autoload-dump（生成自动加载文件后）、post-root-package-install（根包安装完成后）
完整列表见 官方文档 scripts#event-names，别凭经验瞎猜名字——拼错一个字母（比如写成 post-autoloader-dump）就完全不会执行。
脚本值怎么写才有效？
每个事件键对应的值可以是字符串或数组，但含义不同：
- 字符串：直接当 shell 命令执行（在项目根目录下），例如
"php artisan optimize" - 数组：按顺序执行多个操作，支持调用 PHP 回调（格式为
"Vendor\Class::method"）或外部命令
{
"scripts": {
"post-autoload-dump": [
"MyScript\Builder::build",
"php ./bin/generate-config.php"
],
"pre-install-cmd": "echo 'Installing dependencies...'"
}
}
注意：Vendor\Class::method 必须是静态方法，且类必须能被 Composer 自动加载（即已声明在 autoload 里）；否则报 Class not found 错误，且不会提示具体缺哪个类。
为什么本地测试时事件不触发？
常见原因有三个：
- 运行了
composer install --no-scripts或composer update -n，显式禁用了脚本 - 事件名写对了，但对应命令本身失败（比如
phpstan analyse退出码非 0），Composer 默认会中断后续脚本 —— 加@前缀可忽略失败："@phpstan analyse" - 在 CI 环境中使用了缓存的
vendor/，导致post-install-cmd根本没走（因为没真正安装）；改用post-autoload-dump更稳妥
调试技巧：加一句 "echo '>> post-autoload-dump triggered'" 到脚本开头，确认是否进入流程。
PHP 回调里如何访问 Composer 运行上下文？
Composer 会把 ComposerScriptEvent 实例作为唯一参数传给静态方法，从中可获取当前命令、IO 对象、composer 实例等：
namespace MyScript;
use ComposerScriptEvent;
class Builder
{
public static function build(Event $event)
{
$composer = $event->getComposer();
$io = $event->getIO();
$io->write("Building for " . $composer->getPackage()->getName());
}
}
注意：不要在回调里修改 $composer 或 $event 的内部状态，Composer 不保证这些对象的可变性；读取信息没问题，写入可能引发未定义行为。
事件机制看着简单，但实际踩坑多在命名拼写、执行时机判断和回调类加载路径上——尤其当项目用了 psr-4 + classmap 混合自动加载时，Vendor\Class::method 很容易因命名空间与路径不一致而静默失败。
