事件系统

收藏860

阅读118018

更新时间2022-04-15

前言:

事件系统

事件系统

事件系统介绍

Laravel 的事件提供了一个简单的观察者实现,能够订阅和监听应用中发生的各种事件。事件类通常存放在 app/Events 目录下,而这些事件类的监听器则存放在 app/Listeners 目录下。如果在你的应用中你没有看到这些目录,不用担心,它们会在你使用 Artisan 控制台命令生成事件与监听器的时候自动创建。

事件系统为应用各个方面的解耦提供了非常棒的方法,因为单个事件可以拥有多个互不依赖的监听器。举个例子,你可能希望每次订单发货时向用户推送一个 Slack 通知。你可以简单地发起一个可以被监听器接收并转化为 Slack 通知的 OrderShipped 事件,而不是将订单处理代码和 Slack 通知代码耦合在一起。

注册事件和监听器

Laravel 应用中的 EventServiceProvider 为注册所有的事件监听器提供了一个便利的场所。其中, listen 属性包含了所有事件 (键) 以及事件对应的监听器 (值) 的数组。当然,你可以根据应用的需要,添加多个事件到 listen 属性包含的数组中。举个例子,我们来添加一个 OrderShipped 事件:

/**
 * 应用程序的事件监听器映射
 *
 * @var array
 */
 protected $listen = [ 
    'App\Events\OrderShipped' => [    
        'App\Listeners\SendShipmentNotification',  
        ],
    ];

生成事件 & 监听器

当然,手动创建事件和监听器的文件是件麻烦事。而在这里,你只需要将监听器和事件添加到 EventServiceProvider 中,而后使用 event:generate 命令。这个命令会生成在 EventServiceProvider 中列出的所有事件和监听器。当然,已经存在的事件和监听器将保持不变:

php artisan event:generate

手动注册事件

通常,事件是在 EventServiceProvider$listen 数组中注册;然而,你也可以在 EventServiceProviderboot 方法中手动注册基于闭包的这些事件:

/**
 * 注册应用中的其它事件
 *
 * @return void
 */
 public function boot(){ 
    parent::boot();    
    Event::listen('event.name', function ($foo, $bar) {  
          //   
       });
  }

通配符事件监听器

你可以在注册监听器时使用 * 作为通配符参数,这样可以在同一个监听器上捕获多个事件。通配符监听器接收事件名作为其第一个参数,并将整个事件数据数组作为其第二个参数:

Event::listen('event.*', function ($eventName, array $data) { 
   //
});

定义事件

事件类是一个保存与事件相关信息的容器。例如,假设我们生成的 OrderShipped 事件接收一个 Eloquent ORM 对象:

order = $order;  
        }
    }

如你所见,这个事件类中没有包含其它逻辑。它只是一个购买的 Order 的实例的容器。如果使用 PHP 的 serialize 函数序列化事件对象,事件使用的 SerializesModels trait 将会优雅地序列化任何 Eloquent 模型。

定义监听器

接下来,让我们看一下例子中事件的监听器。事件监听器在 handle 方法中接收实例。 event:generate 命令会自动加载正确的事件类,并且在 handle 方法中加入事件的类型提示。在 handle 方法中,你可以执行任何必要的响应事件的操作:

order 来访问 order ...  
        }
     }

{tip} 你的事件监听器也可以在构造函数中加入任何依赖关系的类型提示。所有的事件监听器都是通过 Laravel 的 服务容器 来解析的,因此所有的依赖都将会被自动注入。

停止事件传播

有时,你可以通过在监听器的 handle 方法中返回 false 来阻止事件被其它的监听器获取。

事件监听器队列

如果你的监听器中要执行诸如发送电子邮件或进行 HTTP 请求等比较慢的任务,你可以选择将其丢给队列处理。在开始使用队列监听器之前,请确保在你的服务器或者本地开发环境中能够 配置队列 并启动一个队列监听器。

要指定监听器启动队列,你可以在监听器类中增加 ShouldQueue 接口。由 Artisan 命令 event:generate 生成的监听器已经将此接口导入到当前命名空间中,因此你可以直接使用:

就是这个!当这个监听器被事件调用时,事件调度器会自动使用 Laravel 的 队列系统。如果在队列中执行监听器时没有抛出异常,任务会在执行完成后自动从队列中删除。

自定义队列连接 & 队列名称

如果你想要自定义事件监听器所使用的队列的连接和名称,你可以在监听器类中定义 $connection$queue$delay 属性:

手动访问队列

如果你需要手动访问监听器下面队列任务的 deleterelease 方法,你可以通过使用 Illuminate\Queue\InteractsWithQueue trait 来实现。这个 trait 会默认加载到生成的监听器中,并提供对这些方法的访问:

release(30);  
                  }  
          }
     }

处理失败任务

有时事件监听器的队列任务可能会失败。如果监听器的队列任务超过了队列中定义的最大尝试次数,则会在监听器上调用 failed 方法。 failed 方法接收事件实例和导致失败的异常作为参数:

分发事件

如果要分发事件,你可以将事件实例传递给辅助函数 event 。该辅助函数将会把事件分发到所有该事件相应的已经注册了的监听器上。 event 辅助函数可以全局使用,你可以在应用中的任何位置进行调用:

{tip} 在测试时,只需要断言特定事件被分发,而不需要真正地触发监听器。 Laravel 的 内置测试辅助函数 可以轻松做到这一点。

事件订阅者

编写事件订阅者

事件订阅者是可以在自身内部订阅多个事件的类,即能够在单个类中定义多个事件处理器。订阅者应该定义一个 subscribe 方法,这个方法接收一个事件分发器实例。你可以调用给定事件分发器上的 listen 方法来注册事件监听器:

listen(         
            'Illuminate\Auth\Events\Login',           
            'App\Listeners\UserEventSubscriber@onUserLogin'       
           );        
          $events->listen(         
             'Illuminate\Auth\Events\Logout',            
             'App\Listeners\UserEventSubscriber@onUserLogout'    
              );  
         }
      }

注册事件订阅者

在编写完订阅者之后,就可以通过事件分发器对订阅者进行注册。你可以在 EventServiceProvider 中的 $subscribe 属性中注册订阅者。例如,让我们将 UserEventSubscriber 添加到数组列表中:

本文章首发在 LearnKu.com 网站上。

精选课程

更多
前端入门_HTML5
前端入门_HTML5

共29课时

61.7万人学习

CSS视频教程-玉女心经版
CSS视频教程-玉女心经版

共25课时

39.3万人学习

JavaScript极速入门_玉女心经系列
JavaScript极速入门_玉女心经系列

共43课时

70.9万人学习

独孤九贱(1)_HTML5视频教程
独孤九贱(1)_HTML5视频教程

共25课时

61.6万人学习

独孤九贱(2)_CSS视频教程
独孤九贱(2)_CSS视频教程

共22课时

23万人学习

独孤九贱(3)_JavaScript视频教程
独孤九贱(3)_JavaScript视频教程

共28课时

33.9万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时

125万人学习

关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号