Symfony事件系统基于观察者模式，通过分发和监听事件实现逻辑解耦。首先可创建监听器响应内置事件如kernel.request，在请求开始时记录日志；接着能定义自定义事件如UserRegisteredEvent，封装业务数据并在注册后触发；随后为该事件创建监听器发送欢迎邮件；所有监听器可通过自动配置或手动标签注册；支持设置优先级控制执行顺序，并可调用stopPropagation阻止后续处理。该机制提升应用模块化与可维护性。
Symfony的事件系统是其核心组件之一，它基于观察者模式，允许你在应用程序的不同部分之间解耦逻辑。通过“分发事件”和“监听事件”，你可以实现灵活、可扩展的功能扩展机制。下面介绍如何使用Symfony事件系统，包括内置事件监听、自定义事件创建与触发。
监听Symfony内置事件
Symfony框架在请求处理过程中会自动触发许多内置事件，比如kernel.request、kernel.response等。你可以创建监听器来响应这些事件。
步骤：
- 创建一个PHP类作为事件监听器
- 实现对特定事件的处理逻辑
- 通过配置或注解注册监听器
示例：监听kernel.request事件，在每次请求开始时输出日志。
// src/EventListener/RequestLoggerListener.php namespace App\EventListener;use Symfony\Component\HttpKernel\Event\RequestEvent;
class RequestLoggerListener { public function __invoke(RequestEvent $event) { $request = $event->getRequest(); error_log("请求路径: " . $request->getPathInfo()); } }
该监听器无需额外配置，Symfony会自动发现并注册（需启用自动配置）。
创建和分发自定义事件
当需要在业务逻辑中触发特定行为时，可以定义自己的事件。
1. 创建自定义事件类
虽然Symfony 4.3后推荐使用事件对象直接传递数据，但仍可创建事件类来封装信息。
// src/Event/UserRegisteredEvent.php namespace App\Event;use Symfony\Contracts\EventDispatcher\Event; use App\Entity\User;
class UserRegisteredEvent extends Event { public const NAME = 'user.registered';
public function __construct(private User $user) {} public function getUser(): User { return $this->user; }}
2. 在业务代码中分发事件
使用event_dispatcher服务触发事件。
// 在控制器或服务中 use App\Event\UserRegisteredEvent;public function register(Request $request, EventDispatcherInterface $dispatcher) { // ... 用户注册逻辑 $user = new User(); // 保存用户
// 触发事件 $event = new UserRegisteredEvent($user); $dispatcher->dispatch($event, UserRegisteredEvent::NAME); return new Response('注册成功');}
监听自定义事件
为自定义事件创建监听器，执行后续操作，如发送邮件、记录日志等。
// src/EventListener/SendWelcomeEmailListener.php namespace App\EventListener;use App\Event\UserRegisteredEvent;
class SendWelcomeEmailListener { public function __invoke(UserRegisteredEvent $event) { $user = $event->getUser(); // 发送欢迎邮件逻辑 error_log("发送欢迎邮件给: " . $user->getEmail()); } }
监听器会自动被注册（若
services.yaml中启用了自动配置）。你也可以通过
kernel.event_listener标签手动配置：# config/services.yaml services: App\EventListener\SendWelcomeEmailListener: tags: - { name: kernel.event_listener, event: user.registered }优先级和停止传播
多个监听器可以监听同一个事件，通过设置优先级控制执行顺序。
# 设置高优先级 tags: - { name: kernel.event_listener, event: user.registered, priority: 100 }在监听器中调用$event->stopPropagation()可阻止后续监听器执行。
基本上就这些。Symfony事件系统让代码更模块化，适合处理横切关注点。合理使用能显著提升应用的可维护性。
