Symfony事件订阅者通过实现EventSubscriberInterface接口并定义getSubscribedEvents()方法来集中响应多个事件，支持依赖注入和优先级配置，5.4+默认自动注册，优于监听器适用于多事件协同场景。
Symfony 事件订阅者（Event Subscriber）是一种更灵活、更面向对象的方式来响应事件，相比传统的事件监听器（Listener），它能集中管理多个事件的处理逻辑，并且天然支持依赖注入。
订阅者要实现 EventSubscriberInterface
核心是实现 Symfony\Contracts\EventDispatcher\EventSubscriberInterface 接口，该接口只有一个静态方法 getSubscribedEvents()，用于声明当前类关注哪些事件及对应的处理方法。
示例：
use Symfony\Contracts\EventDispatcher\EventSubscriberInterface;
use App\Event\UserRegisteredEvent;
use App\Event\UserUpdatedEvent;
<p>class UserNotificationSubscriber implements EventSubscriberInterface
{
public static function getSubscribedEvents(): array
{
return [
UserRegisteredEvent::class => 'onUserRegistered',
UserUpdatedEvent::class => ['onUserUpdated', 10], // 优先级为10
];
}</p><pre class='brush:php;toolbar:false;'>public function onUserRegistered(UserRegisteredEvent $event): void
{
// 发送欢迎邮件等逻辑
}
public function onUserUpdated(UserUpdatedEvent $event): void
{
// 记录变更日志等逻辑
}}
注意：getSubscribedEvents() 返回的数组键是事件类名（或事件字符串名），值可以是字符串（方法名）、一维数组（[方法名, 优先级]）或二维数组（支持多方法绑定同一事件）。
自动注册订阅者（推荐用自动发现）
Symfony 5.4+ 默认启用 自动事件订阅者注册，只要你的类实现了 EventSubscriberInterface，且未被明确禁用，就会被自动识别并注册到事件分发器中。
确保 config/services.yaml 中有如下配置（默认已存在）：
services:
# 默认会自动注册所有 EventSubscriberInterface 实现类
App\:
resource: '../src/'
exclude: '../src/DependencyInjection/'
如果需要手动注册（如兼容旧版本或特殊场景），可在 services.yaml 中显式声明：
services:
App\Event\UserNotificationSubscriber:
tags: [{ name: 'kernel.event_subscriber' }]
订阅者 vs 监听器：什么时候选订阅者？
两者都能响应事件，但订阅者更适合以下情况：
- 一个业务逻辑需响应多个相关事件（如用户生命周期：注册、更新、删除）
- 希望把同领域事件处理集中在一个类里，提升可维护性
- 需要在构造函数中注入服务（订阅者和监听器都支持，但订阅者结构更清晰）
- 未来可能扩展事件类型，而不想新增多个监听器类
监听器更适合简单、单事件、轻量级响应（比如日志记录某一个事件）。
调试与验证订阅是否生效
运行命令查看当前注册的所有事件订阅者：
php bin/console debug:event-dispatcher
输出中会列出每个事件对应的所有订阅者方法及其优先级。若没看到你的类，检查：
- 类是否正确实现了 EventSubscriberInterface
- 是否在
src/下且未被exclude规则排除 - 是否拼错事件类名或方法名（PHP 不会报错，但不会触发）
- 容器是否已重建（修改后执行
php bin/console cache:clear）
