资讯专栏INFORMATION COLUMN

Laravel 中的模型事件与 Observer

Yuanf / 2722人阅读

摘要:模型事件在的世界中你对大多数操作都会或多或少的触发一些模型事件今天就来看一下模型事件的使用。事先已经定义好了个模型事件以供我们使用它们分别是。和会在数据库中的真值修改前后触发。监听数据即将保存的事件。监听数据从软删除状态恢复后的事件。

模型事件

Laravel 的世界中,你对 Eloquent 大多数操作都会或多或少的触发一些模型事件,今天就来看一下模型事件的使用。

Laravel 事先已经定义好了 10 个模型事件以供我们使用,它们分别是:

creating, created , updating, updated, saving, saved, deleting, deleted, restoring, restored

事件名称都很浅显易懂,相信如果你是用脑子写代码的话都应该可以看明白,如果不明白的话可以左转百度。

不过你可能对 updating, updated, saving, saved 这四个事件有所疑惑,所以我们来详细分析一下。

打开 IlluminateDatabaseEloquentModel ,找到位于 517 行的 save 方法

笔者使用的是 Laravel 5.5 最新版本,如果你使用的是其他版本,请自行在官方文档 版本差异 中对比你的版本

public function save(array $options = [])
{
    $query = $this->newQueryWithoutScopes();

    if ($this->fireModelEvent("saving") === false) {
        return false;
    }

    if ($this->exists) {
        $saved = $this->isDirty() ?
                    $this->performUpdate($query) : true;
    }

    else {
        $saved = $this->performInsert($query);

        if (! $this->getConnectionName() &&
            $connection = $query->getConnection()) {
            $this->setConnection($connection->getName());
        }
    }

    if ($saved) {
        $this->finishSave($options);
    }

    return $saved;
}

可以看到首先触发的是 saving

$this->fireModelEvent("saving")

接着会判断此 model 是不是新创建的。

如果是新创建的,那么则会进行 insert 操作,由于本例是分析修改操作,所以这里直接略过。

如果不是新创建的,那么会调用 isDirty 方法判断此 model 是否进行了修改。

如果进行了修改,那么会调用 performUpdate 方法进行更新操作,如果没有进行修改,则直接返回 true

让我们点开 performUpdate 方法。

protected function performUpdate(Builder $query)
{
    if ($this->fireModelEvent("updating") === false) {
        return false;
    }

    if ($this->usesTimestamps()) {
        $this->updateTimestamps();
    }

    $dirty = $this->getDirty();

    if (count($dirty) > 0) {
        $this->setKeysForSaveQuery($query)->update($dirty);

        $this->fireModelEvent("updated", false);

        $this->syncChanges();
    }

    return true;
}

可以看到这里会触发 updating

$this->fireModelEvent("updating")

如果返回的不是 false ,那么会接着往下走,判断一下此模型是否使用了 Timestamp,如果使用了,那么则先更新自身的 Timestamp

if ($this->usesTimestamps()) {
    $this->updateTimestamps();
}

接着调用 getDirty,顾名思义,大概可以知道这个方法是获取自身的脏值,让我们点开看一下:

public function getDirty()
{
    $dirty = [];

    foreach ($this->getAttributes() as $key => $value) {
        if (! $this->originalIsEquivalent($key, $value)) {
            $dirty[$key] = $value;
        }
    }

    return $dirty;
}

意料之中,此方法内会返回自身被修改后的脏值,如果你打印过 LaravelModel 实例,那么相信你会看到实例中有 originalattributes 两个数组。

其中 original 保存的是最初始的实例属性,无法被外部直接修改。

attributes 数组则是可以被自有修改,此方法即是由判断两个数组的差异而返回脏值,由于时间原因,这里不做过多详解,有机会单开一个文章慢慢讲。

继续往下走,可以看到这里会判断一下是否有脏值:

if (count($dirty) > 0)

只有在存在脏值的情况下才会进入 if 内部,执行 update 操作,继而触发 updated 事件

update 结束后会执行一下 syncChanges 同步一下自身的数据

OK, performUpdate 方法解析完毕,让我们回到 save 方法,接着往下看,可以看到 Laravel 最后做了一个判断:

if ($saved) {
    $this->finishSave($options);
}

只有在 update 成功的情况下,才会触发 finishSave() 方法,此方法会接收一个参数 $options,即是修改的属性。

让我们点开此方法:

protected function finishSave(array $options)
{
    $this->fireModelEvent("saved", false);

    if ($this->isDirty() && ($options["touch"] ?? true)) {
        $this->touchOwners();
    }

    $this->syncOriginal();
}

可以看到在此方法内会触发 saved 事件

分析完毕,大概可以做一个总结了。

当模型已存在,不是新建的时候,依次触发的顺序是:

saving -> updating -> updated -> saved

当模型不存在,需要新增的时候,依次触发的顺序则是

saving -> creating -> created -> saved

那么 saving,savedupdating,updated 到底有什么区别呢?

上面已经讲过,LaravelEloquent 会维护实例的两个数组,分别是 originalattributes

只有在 saved 事件触发之后,Laravel 才会对两个数组执行 syncOriginal 操作,这样就很好理解了。

updatingupdated 会在数据库中的真值修改前后触发。

savingsaved 则会在 Eloquent 实例的 original 数组真值更改前后触发。

这样我们就可以根据业务场景来选择更合适的触发事件了~

Observer (观察者)

如果你想在一个模型中监听多个事件,那么你可以把它写成一个类,类中的方法名称即是你想要监听的事件名称

class UserObserver
{

    /**
     * 监听数据即将创建的事件。
     *
     * @param  User $user
     * @return void
     */
    public function creating(User $user)
    {

    }

    /**
     * 监听数据创建后的事件。
     *
     * @param  User $user
     * @return void
     */
    public function created(User $user)
    {

    }

    /**
     * 监听数据即将更新的事件。
     *
     * @param  User $user
     * @return void
     */
    public function updating(User $user)
    {

    }

    /**
     * 监听数据更新后的事件。
     *
     * @param  User $user
     * @return void
     */
    public function updated(User $user)
    {

    }

    /**
     * 监听数据即将保存的事件。
     *
     * @param  User $user
     * @return void
     */
    public function saving(User $user)
    {

    }

    /**
     * 监听数据保存后的事件。
     *
     * @param  User $user
     * @return void
     */
    public function saved(User $user)
    {

    }

    /**
     * 监听数据即将删除的事件。
     *
     * @param  User $user
     * @return void
     */
    public function deleting(User $user)
    {

    }

    /**
     * 监听数据删除后的事件。
     *
     * @param  User $user
     * @return void
     */
    public function deleted(User $user)
    {

    }

    /**
     * 监听数据即将从软删除状态恢复的事件。
     *
     * @param  User $user
     * @return void
     */
    public function restoring(User $user)
    {

    }

    /**
     * 监听数据从软删除状态恢复后的事件。
     *
     * @param  User $user
     * @return void
     */
    public function restored(User $user)
    {

    }
}

然后在 AppServiceProvider 中注册此观察者


然后你就可以在你注册的 Observer 中观测到各种事件啦~

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/26187.html

相关文章

  • Laravel学习笔记之Model Observer模型观察者

    摘要:说明本文主要学习下的模型观察者,把一点点经验分享出来希望对别人能有帮助。模型观察者这个功能能做很多事情,比如模型更新时发个通知。总结本篇文章主要学了下的模型观察者,发现这个功能也能使代码结构更清晰,觉得挺好的。 说明:本文主要学习下Laravel的Model Observer模型观察者,把一点点经验分享出来希望对别人能有帮助。同时,作者会将开发过程中的一些截图和代码黏上去,提高阅读效率...

    Crazy_Coder 评论0 收藏0
  • Laravel核心解读--观察者模式

    摘要:模式定义观察者模式定义对象间的一种一对多依赖关系,使得每当一个对象状态发生改变时,其相关依赖对象皆得到通知并被自动更新。 观察者模式 Laravel的Event事件系统提供了一个简单的观察者模式实现,能够订阅和监听应用中发生的各种事件,在PHP的标准库(SPL)里甚至提供了三个接口SplSubject, SplObserver, SplObjectStorage来让开发者更容易地实现观...

    lei___ 评论0 收藏0
  • Laravel学习笔记之Redis保存页面浏览量

    摘要:说明本文主要讲述使用作为缓存加快页面访问速度。何不用来做缓存,等到该达到一定浏览页面后再刷新下,效率也很高。可作缓存系统队列系统。 说明:本文主要讲述使用Redis作为缓存加快页面访问速度。同时,作者会将开发过程中的一些截图和代码黏上去,提高阅读效率。 备注:作者最近在学习github上别人的源码时,发现好多在计算一篇博客页面访问量view_count时都是这么做的:利用Laravel...

    z2xy 评论0 收藏0
  • 使用qq邮箱服务器来实现laravel的邮件发送

    摘要:本文来自原文链接欢迎作客我们的学习群在我们的底层核心技术实战揭秘视频中我们带领大家使用了专业的邮件测试服务来体验邮件发送的前前后后,下面给大家分享下利用邮箱服务器来实现的邮件发送。 本文来自pilishen.com----原文链接; 欢迎作客我们的php&Laravel学习群:109256050 在我们的Laravel底层核心技术实战揭秘 视频中,我们带领大家使用了专业的邮件测试服务m...

    xumenger 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<