Laravel 5.4 事件操作

栏目: 编程语言 · PHP · 发布时间: 7年前

内容简介:Laravel 5.4 事件操作

Laravel 事件机制实现了一个简单的观察者模式,让我们可以订阅和监听应用中出现的各种事件。事件类 (Event) 类通常保存在 app/Events 目录下,而它们的监听类 (Listener) 类被保存在 app/Listeners 目录下。如果你在应用中看不到这些文件夹也不要担心,因为当你使用 Artisan 命令来生成事件和监听器时他们会被自动创建。

事件机制是一种很好的应用解耦方式,因为一个事件可以拥有多个互不依赖的监听器。例如,这里我们基于之前基于模型+缓存对文章增删改查这篇文件对文章保存后缓存的处理做进一步优化。我们将文章保存(新建/修改)视为一个事件,将保存文章内容到缓存放到监听器中实现:

注册事件与监听器

Laravel 应用中的 EventServiceProvider 提供了一个很方便的地方来注册所有的事件监听器。它的 listen 属性是一个数组,包含所有的事件(键)以及事件对应的监听器(值)。你也可以根据应用需求来增加事件到这个数组中。例如,增加一个 PostSaved 事件:

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

生成事件和监听器

当然,手动创建每个事件和监听器是很麻烦的。简单的方式是,在 EventServiceProvider 类中添加好事件和监听器,然后使用 event:generate 命令。这个命令会自动生成 EventServiceProvider 类中列出的所有事件和监听器。当然已经存在的事件和监听器将保持不变。我们在项目根目录运行如下Artisan命令:

$ php artisan event:generate

该命令会在 app/Events 目录下生成 PostSaved.php ,在 app/Listeners 目录下生成 SaveDataToCache.php

手动注册事件

一般来说,事件必须通过 EventServiceProvider 类的 $listen 数组进行注册;不过,你也可以在 EventServiceProvider 类的 boot 方法中注册闭包事件。

/**
 * 注册应用程序中的任何其他事件。
 *
 * @return void
 */
public function boot()
{
    parent::boot();
    
    //name可以使用通配符'*',它让你在一个监听器中可以监听到多个事件。通配符监听器接受的第一个参数是事件名称,第二个参数是整个的事件数据:
    Event::listen('event.name', function ($foo, $bar){
        //
    });
}

定义事件

事件类就是一个包含与事件相关信息数据的容器。接下来我们编辑事件类PostSaved如下:

<?php
namespace App\Events;

use App\Model\Post;
use Illuminate\Broadcasting\Channel;
use Illuminate\Queue\SerializesModels;
use Illuminate\Broadcasting\PrivateChannel;
use Illuminate\Broadcasting\PresenceChannel;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
use Illuminate\Support\Facades\Event;

class PostSavedextends Event
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    /**
     * Create a new event instance.
     *
     * @return void
     */
    public function __construct(Post $post)
    {
        $this->post = $post;
    }

    /**
     * Get the channels the event should broadcast on.
     *
     * @return Channel|array
     */
    public function broadcastOn()
    {
// return new PrivateChannel('channel-name');
        return [];
    }
}

正如你所见,这个事件类中没有包含其它逻辑。它仅只是一个被构建的 Post 对象的容器。如果使用 PHPserialize 函数对事件进行序列化,使用了 SerializesModels trait 的事件将会优雅的序列化任何的 Eloquent 模型。

定义监听器

接下来,让我们看一下例子中事件的监听器。事件监听器在 handle 方法中接受了事件实例作为参数。 event:generate 命令将会在事件的 handle 方法中自动加载正确的事件类和类型提示。在 handle 方法中,你可以运行任何需要响应该事件的业务逻辑。

<?php

namespace App\Listeners;

use App\Events\PostSaved;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Log;

class PostSavedToCache
{
    /**
     * Create the event listener.
     *
     * @return void
     */
    public function __construct()
    {
        //
    }

    /**
     * Handle the event.
     *
     * @param  PostSaved  $event
     * @return void
     */
    public function handle(PostSaved $event)
    {
        $post = $event->post;
        $key = 'post_'.$post->id;
        Cache::put($key,$post,60*24*7);
        Log::info('保存文章到缓存文件', ['id' => $post->id, 'title' => $post->title]);
    }
}

停止事件传播

有时,你可能希望停止一个事件传播到其他的监听器。这时你可以通过在监听器的 handle 方法中返回 false 来实现。

触发事件

最后我们来测试文章保存事件及其监听器。

要触发文章保存事件,可以使用 Event 门面提供的 fire 方法,在 PostController 中修改 add 方法如下:

public function add(Request $request)
{
    $post = new Post();
    $post->title = $request->input('title');
    $post->content = $request->input('content');
    if($post->save()){
        event(new PostSaved($post));
    }
    return redirect('post');
}

访问浏览器添加文章,添加后查看日志 storage/logs/laravel.log

[2017-03-22 03:27:25] local.INFO: 保存文章到缓存文件 {"id":115,"title":"标题1"}

说明已触发文章保存事件,监听器监听到事件后将其保存到缓存中并记录日志。


以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

引爆社群:移动互联网时代的新4C法则(第2版)

引爆社群:移动互联网时代的新4C法则(第2版)

唐兴通 / 机械工业出版社 / 69.00元

社群已经被公认为是这个时代的商业新形态,原有的商业逻辑和方法被颠覆,新的基于社群的商业体系和规则亟待构建,今天几乎所有的企业都在为此而努力,都在摸索中前行。 本书提出的“新4C法则”为社群时代的商业践行提供了一套科学的、有效的、闭环的方法论,第1版上市后获得了大量企业和读者的追捧,“新4C法则”在各行各业被大量解读和应用,积累了越来越多的成功案例,被公认为是社群时代通用的方法论。也因此,第1......一起来看看 《引爆社群:移动互联网时代的新4C法则(第2版)》 这本书的介绍吧!

JS 压缩/解压工具
JS 压缩/解压工具

在线压缩/解压 JS 代码

SHA 加密
SHA 加密

SHA 加密工具

Markdown 在线编辑器
Markdown 在线编辑器

Markdown 在线编辑器