快速入门Laravel模型事件

内容导读

互联网集市收集整理的这篇技术教程文章主要介绍了快速入门Laravel模型事件，小编现在分享给大家，供广大互联网技能从业者学习和参考。文章包含5956字，纯文字阅读大概需要9分钟。

内容图文

事件概述

Eloquent 有很多事件可以让你使用钩子将它们关联起来，并且增加自定义的功能到你的模型中。该模型起始时有以下事件：

retrieved

creating

created

updating

updated

saving

saved

deleting

deleted

restoring

restored

从文档这里我们可以了解它们都是如何实现的，你还可以进入 Model 的基类去看看它们到底是如何实现的:

当现有模型被数据库检索时， retrieved 事件将会触发。当一个新的模型被第一次保存时， creating 和 created 事件将会触发。如果对一个已经存在于数据库的模型调用 save 方法， updating / updated 事件将会触发。无论怎样，在这两种情况下， saving / saved 事件都会触发。

文档中对模型事件进行了很好的概述，同时解释了怎样使用钩子去关联事件，但是如果你是初学者，或者并不是熟悉怎样使用钩子将事件监听器与这些自定义模型事件相关联，请进一步阅读本文。

注册 事件

为了在你的模型中关联一个事件，你需要做的第一件事是使用 $dispatchesEvents 属性去注册事件对象，这最终将通过 HasEvents::fireCustomModelEvent() 方法触发，该方法将通过 fireModelEvent() 方法被调用。 fireCustomModelEvent() 方法原始的时候大致是下面这样:

/**
 * 为给定的事件触发一个自定义模型。
 *
 * @param  string  $event
 * @param  string  $method
 * @return mixed|null
 */
protected function fireCustomModelEvent($event, $method)
{
    if (! isset($this->dispatchesEvents[$event])) {
        return;
    }
    $result = static::$dispatcher->$method(new $this->dispatchesEvents[$event]($this));
    if (! is_null($result)) {
        return $result;
    }
}

一些事件，比如 delete, 将进行检测判断是否这个事件会返回 false 然后退出操作。比如，你可以使用这个钩子去做一些检测，也可以防止一个用户被创建或删除。

使用 App\User 模型举例，这里展示了如何配置你的模型事件：

protected $dispatchesEvents = [
    'saving' => \App\Events\UserSaving::class,
];

你可以使用 artisan make:event 命令来为你创建这个事件，但基本上这将是你最后得到结果 ：

<?php
namespace App\Events;
use App\User;
use Illuminate\Queue\SerializesModels;
class UserSaving
{
    use SerializesModels;
    public $user;
    /**
     *  创建一个新的事件实例
     *
     * @param \App\User $user
     */
    public function __construct(User $user)
    {
        $this->user = $user;
    }
}

我们的事件提供了一个公有的 $user 属性以便你能够在 saving 事件期间访问 User 模型实例。

为了让它工作起来下一步需要做的是为这个事件建立一个实际的监听器。我们设置好模型的触发时机，当 User 模型触发 saving 事件，监听器就会被调。

创建一个事件监听器

现在，我们定义 User 模型并注册一个事件监听器来监听 saving 事件的触发。虽然，我能通过模型观察器快速实现，但是，我想引导你为单个事件触发配置事件监听器。

事件监听器就像 Laravel 其它事件监听一样，handle() 方法将接收 App\Events\UserSaving 事件类的一个实例。

你可以手动创建它，也可以使用 php artisan make:listener 命令。 不管怎么样，你都将创建一个像下面这样子监听类：

<?php
namespace App\Listeners;
use App\Events\UserSaving as UserSavingEvent;
class UserSaving
{
    /**
     * 处理事件。
     *
     * @param  \App\Events\UserSavingEvent $event
     * @return mixed
     */
    public function handle(UserSavingEvent $event)
    {
        app('log')->info($event->user);
    }
}

我只是添加了一个日志记录调用，以便于检查传递给监听器的模型。为此，我们还需要在 EventServiceProvider::$listen 属性中注册监听器：

<?php
namespace App\Providers;
use Illuminate\Support\Facades\Event;
use Illuminate\Foundation\Support\Providers\EventServiceProvider as ServiceProvider;
class EventServiceProvider extends ServiceProvider
{
    /**
     * 应用的事件监听器。
     * 
     * @var array
     */
    protected $listen = [
        \App\Events\UserSaving::class => [
            \App\Listeners\UserSaving::class,
        ],
    ];
    // ...
}

现在，当模型调用 saving 事件时，我们注册的事件监听器也会被触发并执行。

尝试事件监听

我们可以通过 tinker 会话快速生成事件监听代码：

php artisan tinker
>>> factory(\App\User::class)->create();
=> App\User {#794
     name: "Aiden Cremin",
     email: "josie05@example.com",
     updated_at: "2018-03-15 03:57:18",
     created_at: "2018-03-15 03:57:18",
     id: 2,
   }

如果你已正确注册了事件和监听器，则应该在 laravel.log 文件中可以看到该模型的 JSON 表达形式：

[2018-03-15 03:57:18] local.INFO: {"name":"Aiden Cremin","email":"josie05@example.com"}

要注意的一点，此时模型并没有 created_at 或 updated_at 属性。如果在模型上再次调用 save() ，日志上将会有一个带有时间戳的新记录，因为 saving 事件会在新创建的记录或现在有记录上触发：

>>> $u = factory(\App\User::class)->create();
=> App\User {#741
     name: "Eloisa Hirthe",
     email: "gottlieb.itzel@example.com",
     updated_at: "2018-03-15 03:59:37",
     created_at: "2018-03-15 03:59:37",
     id: 3,
   }
>>> $u->save();
=> true
>>>

停止一个保存操作

某些模型事件是允许你进行阻止操作的。举个荒谬的例子，假设我们不允许任何一个用户的模型保存其属性 $user->name 的内容为 Paul ：

/**
 * 处理事件。
 *
 * @param  \App\Events\UserSaving $event
 * @return mixed
 */
public function handle(UserSaving $event)
{
    if (stripos($event->user->name, 'paul') !== false) {
        return false;
    }
}

在 Eloquent 的 Model::save() 方法中，会根据事件监听的返回结果判断是否进行停止保存操作：

public function save(array $options = [])
{
    $query = $this->newQueryWithoutScopes();
    // 如果 "saving" 事件返回 false ，我们将退出保存并返回
    // false，表示保存失败。这为服务监听者提供了一个机会，
    // 当验证失败或者出现其它任何情况，都可以取消保存操作。
    if ($this->fireModelEvent('saving') === false) {
        return false;
    }

这个 save() 是个很好的例子，它告诉了你如何在模型生命周期中自定义事件，以及被动执行日志数据记录或者任务调度。

使用观察者

如果你正在监听多个事件，那么你可能会发现使用观察者类来按类型分组存放事件会更加方便。这里是一个例子 Eloquent 观察者 ：

<?php
namespace App\Observers;
use App\User;
class UserObserver
{
    /**
     * 监听 User 创建事件。
     *
     * @param  \App\User  $user
     * @return void
     */
    public function created(User $user)
    {
        //
    }
    /**
     * 监听 User 删除事件。
     *
     * @param  \App\User  $user
     * @return void
     */
    public function deleting(User $user)
    {
        //
    }
}

你可以在服务提供者 AppServiceProvider 中的 boot() 方法里注册观察者。

/**
 * 运行所有应用服务。
 *
 * @return void
 */
public function boot()
{
    User::observe(UserObserver::class);
}

推荐教程：《Laravel教程》

以上就是快速入门Laravel模型事件的详细内容。

内容总结

以上是互联网集市为您收集整理的快速入门Laravel模型事件全部内容，希望文章能够帮你解决快速入门Laravel模型事件所遇到的程序开发问题。 如果觉得互联网集市技术教程内容还不错，欢迎将互联网集市网站推荐给程序员好友。

内容备注

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 gblab@vip.qq.com 举报，一经查实，本站将立刻删除。

内容手机端