必须监听内核事件（如kernel.request）才能介入Symfony请求生命周期；通过服务标签注册监听器并确保类路径、事件名、方法名拼写准确；多事件场景推荐使用EventSubscriberInterface并设置优先级。
要在 Symfony 应用中响应请求进入、控制器执行、响应生成等关键节点，必须监听内核生命周期事件，比如 kernel.request、kernel.response、kernel.exception 等——这些事件由 HttpKernel 触发，是介入处理流程的唯一标准入口，不通过事件监听就无法在框架层面统一拦截或修改行为。
注册监听器：服务标签方式
在 config/services.yaml 中声明监听器服务并打上对应事件标签：
复制以下配置到 services.yaml 的 services 节点下：
```yaml
App\EventListener\RequestLoggerListener:
tags:
- { name: kernel.event_listener, event: kernel.request, method: onKernelRequest }
```
这一步必须确保类名与文件路径完全匹配（如类在 src/EventListener/RequestLoggerListener.php），否则容器无法加载。
标签中的 【event: kernel.request】 是硬编码字符串，拼错一个字母（如写成 kernel.requst）会导致监听器完全失效，且无任何报错提示。
编写监听器类：以 kernel.request 为例
创建文件 src/EventListener/RequestLoggerListener.php：
```php
namespace App\EventListener;
use Symfony\Component\HttpKernel\Event\RequestEvent;
class RequestLoggerListener
{
public function onKernelRequest(RequestEvent $event): void
{
if (!$event->isMainRequest()) {
return;
}
$request = $event->getRequest();
file_put_contents('/tmp/request.log', sprintf("[%s] %s\n", date('c'), $request->getPathInfo()), FILE_APPEND);
}
}
```
注意：必须调用 【$event->isMainRequest()】 判断，否则子请求（如嵌入式控制器、ESI 包含）也会触发该逻辑，导致日志重复或性能异常。
方法名 onKernelRequest 是约定俗成的命名，若改为 onKernelReqest 将不会被自动识别——Symfony 不做方法名拼写校验，只按字面匹配。
使用事件订阅器替代监听器
当一个类需要监听多个事件时，推荐用 EventSubscriberInterface，避免在服务配置中重复声明多个标签。
第一步：实现接口并定义 getSubscribedEvents()
```php
use Symfony\Contracts\EventDispatcher\EventSubscriberInterface;
class ResponseHeaderSubscriber implements EventSubscriberInterface
{
public static function getSubscribedEvents(): array
{
return [
'kernel.response' => 'onKernelResponse',
'kernel.terminate' => ['onKernelTerminate', 10],
];
}
public function onKernelResponse(RequestEvent $event): void { /* ... */ }
public function onKernelTerminate(RequestEvent $event): void { /* ... */ }
}
```
第二步：在 services.yaml 中仅需注册服务，无需标签
```yaml
App\EventSubscriber\ResponseHeaderSubscriber: ~
```
第三步：确认类自动启用——若未生效，运行 bin/console debug:event-dispatcher --show-listeners 查看是否列出该订阅器。
getSubscribedEvents 返回数组中，【'kernel.terminate' => ['onKernelTerminate', 10]】 的第二个元素是优先级，数字越大越早执行；若与其他 terminate 监听器冲突，此处值必须显式设置，否则默认为 0，可能被覆盖。
验证监听器是否生效
执行命令：bin/console debug:event-dispatcher kernel.request
查看输出中是否包含你的监听器类全名和方法名。
若无输出，说明服务未正确注册或类路径错误——此时不要检查代码逻辑，先确认 bin/console debug:container | grep Listener 是否列出该服务。
访问任意路由，检查 /tmp/request.log 是否新增一行记录。
