在 composer.json 的 "scripts" 中定义命令别名与执行逻辑，支持字符串、数组和 PHP 回调形式；需注意命名规范、事件触发时机、@ 引用机制及自定义脚本类的自动加载配置。
composer.json 里 scripts 字段怎么写才有效
直接在 composer.json 的 "scripts" 对象里定义键值对，键是命令别名，值是具体要执行的命令或 PHP 回调。Composer 不会校验值是否合法，写错只会运行时报错或静默失败。
- 字符串值：会被 shell 执行，支持
php、npm、路径命令等，如"test": "phpunit" - 数组值：按顺序执行多条命令，如
"post-install-cmd": ["@php script/install.php", "chmod +x bin/*"] - PHP 回调：用
["MyClass::myMethod"]或["php", "script.php"]形式，必须可被自动加载或显式 require - 脚本名不能含空格，推荐用短横线分隔，如
build:assets，避免build assets（会被拆成两个命令）
如何触发 post-autoload-dump 后自动清理旧的 classmap 缓存
这个事件在 composer install 或 composer update 生成新 autoloader 后触发，适合做依赖变更后的清理或预热。但要注意：它不保证 vendor 已完全就绪（比如某些插件可能还没复制完），也不在 composer dump-autoload 单独运行时触发（除非加 --optimize）。
- 在
"scripts"中添加："post-autoload-dump": "rm -f var/cache/classmap.php" - 若用 PHP 脚本，需确保该文件能被当前 autoloader 加载（推荐放
scripts/下并加到"autoload-dev"的"psr-4"） - Windows 用户慎用
rm，改用del或跨平台 PHP 实现：["php", "-r", "unlink('var/cache/classmap.php');"]
scripts 中调用其他 script 别名要用 @ 符号前缀
想复用已有脚本逻辑，比如测试前先构建资产，不能直接写 "test": "npm run build && phpunit"，而应优先用 @ 引用，这样 Composer 会统一处理环境、错误传播和事件钩子。
- 正确写法：
"test": ["@build:assets", "phpunit"] -
@只能引用同级 script 名，不支持带参数（如@dev:server --port=8080会报错） - 嵌套过深（比如 A → B → C → A）会导致循环检测失败，报
Script xxx is looping - 如果被引用的 script 返回非零退出码，整个链会中断，除非加
|| true显式忽略（不推荐）
自定义脚本类怎么注册才能被 Composer 识别
写一个 PHP 类处理复杂逻辑（比如读取配置、发 HTTP 请求、生成文件），需要满足两个条件：类可被自动加载，且方法是 public static。Composer 不会实例化对象，只调静态方法。
- 示例类：
class BuildHelper { public static function compileAssets($event) { $vendorDir = $event->getComposer()->getConfig()->get('vendor-dir'); exec("node_modules/.bin/rollup -c rollup.config.js"); } } - 在
composer.json中注册："scripts": {"build:js": ["BuildHelper::compileAssets"]} - 必须把类所在目录加入
"autoload-dev"（如"src/Scripts/": ["src/Scripts"]），然后运行composer dump-autoload - 方法参数可选接收
Composer\Script\Event对象，从中获取 composer 实例、IO、输入参数等；没传参也不会报错
最易被忽略的是 autoload 配置没生效或类命名空间与文件路径不匹配——这时候脚本看似运行了，实际什么都没做，也没有错误提示。
