Composer 无中文事件机制，所有事件名均为英文且不可自定义；仅能通过脚本或插件挂载到预定义事件（如post-install-cmd、post-autoload-dump）上实现扩展。
Composer 本身没有“中文 Event 分发机制”，也不存在官方支持的、以中文命名或专为中文环境设计的事件系统。所有 Composer 事件（如 pre-install-cmd、post-autoload-dump）都是英文的、由 Composer 内核定义的固定字符串，语言层面与中文无关。
Composer 的事件机制本质是钩子（hook），不是可扩展的 Event Bus
Composer 的事件基于 EventDispatcher 类，但它只响应预定义的事件名（全部英文），不支持运行时注册任意事件名，也不提供类似 Laravel 的 Event::dispatch() 或 Symfony 的 EventDispatcherInterface 那种松耦合分发能力。所谓“自定义构建生命周期”，实际只能通过组合现有事件 + 自定义脚本实现。
- 所有可用事件都在 官方文档 列出，例如
pre-autoload-dump、post-root-package-install - 你无法声明一个叫
post-zh-build或pre-编译资源的事件并让 Composer 触发它 - 脚本执行顺序严格依赖事件名和注册位置（
scripts段 vs 插件），无优先级控制或中间件机制
在 composer.json 中绑定脚本到标准事件
这是最常用且唯一可靠的方式。把你的逻辑封装成命令（PHP 脚本、Shell 命令或可执行文件），然后挂载到 Composer 认可的事件上。
例如，想在 composer install 后生成中文文档：
{
"scripts": {
"post-install-cmd": [
"php ./scripts/generate-zh-docs.php"
],
"post-update-cmd": [
"@post-install-cmd"
]
}
}
-
post-install-cmd和post-update-cmd是两个独立事件，需显式复用（用@xxx引用） - 脚本路径必须可执行（PHP 文件需有 shebang 或用
php xxx.php显式调用） - 若脚本失败（exit code ≠ 0），整个 Composer 命令会中止 —— 这常被忽略，导致 CI 流程意外中断
用 Composer Plugin 实现更细粒度控制
如果你需要监听事件时获取上下文（如当前安装的包列表、配置选项），或动态修改行为（如跳过某包的 autoload 生成），就必须写 Plugin。Plugin 是 PHP 类，实现 Composer\Plugin\PluginInterface，并在 activate() 中监听事件。
示例片段（监听 PostAutoloadDumpEvent）：
use Composer\EventDispatcher\EventSubscriberInterface;
use Composer\Script\Event;
use Composer\Installer\PackageEvent;
class ZhBuildPlugin implements EventSubscriberInterface
{
public static function getSubscribedEvents()
{
return [
'post-autoload-dump' => 'onPostAutoloadDump',
];
}
public function onPostAutoloadDump(Event $event)
{
$vendorDir = $event->getComposer()->getConfig()->get('vendor-dir');
// 执行中文相关构建逻辑，比如生成本地化 classmap
}
}
- Plugin 必须声明为
type: composer-plugin，并在extra.plugin-class指定入口类 - 不能直接在 Plugin 里 echo 输出到终端 —— 应使用
$event->getIO()->write()，否则可能被静默丢弃 - Plugin 加载早于用户脚本，但无法拦截或修改事件传播链，仅能响应
真正要实现“自定义构建生命周期”，关键不在语言，而在对 Composer 事件触发时机的理解和脚本/Plugin 的组合编排。中文命名的脚本文件或日志输出可以有，但事件名、接口契约、配置键都必须遵守 Composer 的英文约定。最容易被忽略的是：事件执行失败默认中断流程，而很多团队把它当成“后台任务”来写，结果在生产部署时卡住不动。
