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