Symfony命令消息总线通过EventDispatcher模拟，以CommandStartedEvent、CommandSucceededEvent、CommandFailedEvent三类语义化事件解耦横切关注点；事件需继承Symfony\Contracts\EventDispatcher\Event，使用只读属性和类型声明；监听器通过服务标签或#[AsEventListener]注册，支持stopPropagation()和优先级控制。
Symfony 命令消息总线不是官方组件，但开发者常将 EventDispatcher 与命令（Command）结合，模拟“消息总线”行为：把命令执行当作事件源，用事件分发替代直接调用，实现解耦与可扩展。关键不在于替换 Console 组件，而在于用 Event 和 EventDispatcherInterface 构建语义清晰、可拦截、可审计的命令生命周期通信机制。
命令作为事件触发点
不把命令类本身当消息，而是让它在关键节点 dispatch 语义化事件：
-
CommandStartedEvent：在
execute()开头触发，携带命令名、输入参数、用户上下文 - CommandSucceededEvent：操作成功后触发，附带结果摘要或生成资源 ID
- CommandFailedEvent：捕获异常后触发，含错误类型、堆栈片段（脱敏后）
这样，日志记录、指标上报、通知推送等横切关注点全部移出命令体，由监听器统一处理。
事件类设计要点
自定义事件必须继承 Symfony\Contracts\EventDispatcher\Event，才能启用传播控制：
- 只封装必要数据，例如
CommandStartedEvent只存$input和$commandName，不存$output或容器实例 - 使用类型声明和只读属性（PHP 8.1+），如
private readonly string $commandName; - 避免在事件构造中触发副作用（如写日志、查数据库）
调度器集成方式
推荐在命令基类或命令运行器（CommandBus）中注入 EventDispatcherInterface：
- 在 Symfony 应用中，通过依赖注入自动传入；无需手动 new EventDispatcher
- 若需调试追踪，用
TraceableEventDispatcher替换默认实例，它会自动记录每个监听器耗时与调用状态 - 监听器注册支持多种方式：服务标签（
kernel.event_listener）、#[AsEventListener]属性（PHP 8.2+）、或运行时addListener()
实战中的传播控制与优先级
某些监听器需前置干预或终止流程：
- 权限检查监听器可在
CommandStartedEvent中调用$event->stopPropagation()，阻止后续监听器执行 - 审计监听器设高优先级（如
priority: 1024），确保最先记录原始输入 - 通知监听器设低优先级（如
priority: -256），仅在成功/失败确定后再发送
注意：停止传播不影响当前监听器已执行的逻辑，只跳过后续监听器。
