composer脚本需用官方事件名（如post-autoload-dump）绑定命令或"class::method"，类须可自动加载且方法为static；ci中post-install-cmd不执行常因--no-scripts参数。
composer.json 里怎么写 scripts 才能触发事件
Composer 的脚本机制本质是事件驱动的，不是“监听”而是“绑定”——scripts 字段下声明的键名就是事件名，值是待执行的命令或回调。官方预定义了几十个事件（如 pre-install-cmd、post-autoload-dump），你写的键只要匹配这些名称，就会在对应时机自动运行。
常见错误是把自定义脚本名当成事件名来用，比如写了 "my-check": "php check.php" 却指望它在 install 后自动跑——它不会，除非你手动执行 composer run my-check 或在别的事件里调用它。
- 必须使用 Composer 官方文档列出的事件名（见 Scripts Event Names）
- 事件名区分大小写，
post-install-cmd和postInstallCmd是两回事 - 多个脚本可共用一个事件，按数组顺序执行：
"post-autoload-dump": ["@php build/autoload.php", "npm run build"]
如何让 PHP 类方法响应 composer 事件
直接写类方法路径到 scripts 是可行的，但要注意格式：必须是 "ClassName::methodName"，且该类需能被 Composer 自动加载（即已出现在 autoload 或 autoload-dev 配置中）。
例如你在 src/Script/BuildHook.php 里定义了 public static function onPostAutoloadDump()，那 composer.json 中应这样写：
"scripts": {
"post-autoload-dump": [
"App\Script\BuildHook::onPostAutoloadDump"
]
}
容易踩的坑：
- 没加
static关键字 → 报错Non-static method ... cannot be called statically - 命名空间与文件路径不一致，或
autoload没包含该目录 → 报错Class not found - 方法参数必须为空或只接受
$event（ComposerScriptEvent实例），多传参会失败
为什么 post-install-cmd 不在 CI 环境执行
默认情况下，composer install 在 CI 或 --no-interaction 模式下会跳过某些脚本，尤其是涉及交互或耗时操作的。但更常见的原因是：你用了 composer install --no-scripts（很多 CI 模板默认加这个）。
检查你的 CI 脚本或本地执行命令是否含 --no-scripts 或 -n。如果确实需要禁用部分脚本又保留关键事件，可以用 --no-plugins 替代，或改用更精准的事件，比如：
-
post-autoload-dump更稳定，几乎所有 install/update 都会触发 -
post-root-package-install只在根项目 install 时触发一次，适合初始化配置 - 避免依赖
pre-update-cmd，它在 lock 文件未变时可能不执行
调试脚本执行失败的最快方式
脚本静默失败最烦人。别靠猜，用 Composer 内置调试开关：
- 加
-v（verbose）看完整执行链：composer install -v - 加
--no-cache排除缓存干扰 - 在脚本命令前加
echo "DEBUG: running..." &&快速确认是否进入 - PHP 方法内加
file_put_contents('debug.log', print_r($event, true), FILE_APPEND);记录事件上下文
特别注意：如果脚本返回非零退出码（比如 PHP die() 或命令失败），整个 Composer 命令会中断，后续事件也不会触发——这是设计行为，不是 bug。
