事件和事件监听器
编辑该页面警告:你浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 4.1,不再维护。
读这个页面的更新版本Symf欧宝娱乐app下载地址ony 6.2(当前的稳定版本)。
事件和事件监听器
Symfony应用程序执行期间,大量的触发事件通知。欧宝娱乐app下载地址您的应用程序可以听这些通知和应对他们通过执行任何代码。
欧宝娱乐app下载地址Symfony触发几个事件相关的内核在处理HTTP请求。第三方包也可能分派事件,你甚至可以派遣自定义事件从您自己的代码。
本文中所示的示例使用相同KernelEvents:异常事件的一致性的目的。在您自己的应用程序中,您可以使用任何事件,甚至混合其中几个在同一用户。
创建一个事件监听器
听一个事件最常见的方法是注册一个事件监听器:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30 31 32 33 34 35 36
/ / src / EventListener / ExceptionListener.php名称空间应用程序\EventListener;使用欧宝娱乐app下载地址\组件\HttpKernel\事件\GetResponseForExceptionEvent;使用欧宝娱乐app下载地址\组件\HttpFoundation\响应;使用欧宝娱乐app下载地址\组件\HttpKernel\异常\HttpExceptionInterface;类ExceptionListener{公共函数onKernelException(GetResponseForExceptionEvent美元事件){/ /得到的异常对象接收到的事件美元异常=美元事件- >getException ();美元消息= sprintf (我的错误说:% s代码:% s的,美元异常- >getMessage (),美元异常- >getCode ());/ /定制响应对象显示异常的细节美元响应=新反应();美元响应- >setContent (美元消息);/ / HttpExceptionInterface是一种特殊类型的异常/ /保存状态代码和头的细节如果(美元异常运算符HttpExceptionInterface) {美元响应- >setStatusCode (美元异常- >getStatusCode ());美元响应- >头- >替换(美元异常- >getHeaders ());}其他的{美元响应- >setStatusCode(响应::HTTP_INTERNAL_SERVER_ERROR);}/ /发送修改后的响应对象的事件美元事件- >setResponse (美元响应);}}提示
每个事件接收一个稍微不同的类型的美元的事件对象。为kernel.exception事件,GetResponseForExceptionEvent。检查欧宝娱乐app下载地址Symfony事件参考每个事件提供什么类型的对象。
现在创建了类,你需要注册一个服务并通知Symfony,它是一个“听众”欧宝娱乐app下载地址kernel.exception事件通过使用一个特殊的“标签”:
- YAML
- XML
- PHP
1 2 3 4 5
#配置/ services.yaml服务:App \ EventListener \ ExceptionListener:标签:- - - - - -{名称:kernel.event_listener,事件:kernel.exception}欧宝娱乐app下载地址Symfony遵循这种逻辑来决定哪个方法执行内部的事件侦听器类:
- 如果
kernel.event_listener标签定义了方法属性,这是要执行的方法的名称; - 如果没有
方法定义属性,尝试执行方法的名字在+”“骆峰式”事件名称”(如。onKernelException ()方法kernel.exception事件); - 如果没有定义方法,尝试执行
__invoke ()魔术方法(这使得事件监听器调用); - 如果
_invoke ()方法也不是定义,抛出一个异常。
4.1
的支持__invoke ()方法来创建调用事件监听器是在Symfony 4.1中引入的。欧宝娱乐app下载地址
请注意
有一个可选属性kernel.event_listener标签被称为优先级,这是一个积极或消极的整数,默认0和它控制的顺序执行侦听器(数字越高,越早一个侦听器执行)。这是有用的,当你需要保证一个侦听器之前执行另一个。内部的优先级Symfony听众通常范围从欧宝娱乐app下载地址-255年来255年但自己的听众可以使用任何积极或消极的整数。
创建一个事件订阅者
听事件的另一种方法是通过一个事件订阅者,这是一个类,它定义了一个或多个方法,听一个或各种事件。事件监听器的主要区别是,用户总是知道他们正在听哪些事件。
在一个给定的用户,不同的方法可以听同样的事件。定义方法的顺序执行的优先级每个方法的参数(数字越高越早方法被调用)。了解更多关于事件订阅者,阅读EventDispatcher组件。
下面的示例显示了一个事件订阅者,定义了一些方法,听一样的kernel.exception事件:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30 31 32 33 34 35 36
/ / src / EventSubscriber / ExceptionSubscriber.php名称空间应用程序\EventSubscriber;使用欧宝娱乐app下载地址\组件\EventDispatcher\EventSubscriberInterface;使用欧宝娱乐app下载地址\组件\HttpKernel\事件\GetResponseForExceptionEvent;使用欧宝娱乐app下载地址\组件\HttpKernel\KernelEvents;类ExceptionSubscriber实现了EventSubscriberInterface{公共静态函数getSubscribedEvents(){/ /返回订阅事件,他们的方法和重点返回[KernelEvents::异常= > [[“processException”,10]、[“logException”,0]、[“notifyException”,-10年]]];}公共函数processException(GetResponseForExceptionEvent美元事件){/ /……}公共函数logException(GetResponseForExceptionEvent美元事件){/ /……}公共函数notifyException(GetResponseForExceptionEvent美元事件){/ /……}}就是这样!你的services.yaml文件应该已经设置加载服务的EventSubscriber目录中。欧宝娱乐app下载地址Symfony的休息。
提示
如果你的方法不时调用将抛出一个异常,检查你的加载服务从EventSubscriber目录,可以使用autoconfigure启用。你也可以手动添加kernel.event_subscriber标签。
请求事件,检查类型
一个页面可以使多个请求(一个主请求,然后——通常由多个子请求如何将控制器嵌入到一个模板)。核心Symfony的事件,欧宝娱乐app下载地址您可能需要检查的事件是“主”请求或“子请求”:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ / src / EventListener / RequestListener.php名称空间应用程序\EventListener;使用欧宝娱乐app下载地址\组件\HttpKernel\事件\GetResponseEvent;类RequestListener{公共函数onKernelRequest(GetResponseEvent美元事件){如果(!美元事件- >isMasterRequest ()) {/ /不做任何事如果不主请求返回;}/ /……}}某些事情,比如检查信息真正的请求,可能不需要做sub-request听众。
听众或用户
听众和用户可以在同一个应用程序中朦胧地。使用他们的决定通常是个人口味的问题。然而,他们每个人有一些小的优势:
- 用户更容易重用因为事件是在类的知识,而不是在服务定义。这就是为什么Symfony使用内部用户;欧宝娱乐app下载地址
- 听众更加灵活因为包可以启用或禁用他们每个人有条件地根据一些配置值。
调试事件监听器
你可以找出监听器注册事件调度器使用控制台。显示所有事件和他们的听众,运行:
1
美元php bin /控制台调试:事件分配器你可以为一个特定的事件注册监听器通过指定它的名字:
1
美元php bin /控制台调试:事件分配器kernel.exception
