事件

模型事件

版本 新增功能
5.0.4 增加模型事件注冊快捷方法

模型事件是指在進行模型的寫入操作的時候觸發(fā)的操作行為,包括模型的save方法和delete方法。

模型事件只可以在調(diào)用模型的方法才能生效,使用查詢構(gòu)造器通過Db類操作是無效的

模型類支持before_delete、after_deletebefore_write、after_write、before_update、after_updatebefore_insert、after_insert事件行為

標簽位 描述
before_insert 新增前
after_insert 新增后
before_update 更新前
after_update 更新后
before_write 寫入前
after_write 寫入后
before_delete 刪除前
after_delete 刪除后

使用方法如下:

User::event('before_insert', function ($user) {
            if ($user->status != 1) {
                return false;
            }
        });

注冊的回調(diào)方法支持傳入一個參數(shù)(當前的模型對象實例),并且before_write、before_insert、 before_update 、before_delete事件方法如果返回false,則不會繼續(xù)執(zhí)行。

支持給一個位置注冊多個回調(diào)方法,例如:

        User::event('before_insert', function ($user) {
            if ($user->status != 1) {
                return false;
            }
        });
        // 注冊回調(diào)到beforeInsert函數(shù)
        User::event('before_insert', 'beforeInsert');

可以在模型類的init方法里面統(tǒng)一注冊模型事件,例如:

namespace app\index\model;

use think\Model;

class User extends Model
{
    protected static function init()
    {
        User::event('before_insert', function ($user) {
            if ($user->status != 1) {
                return false;
            }
        });
    }
}

調(diào)用當前模型也可以寫入 self::event('before_insert', ...)

快捷注冊(V5.0.4+

V5.0.4+版本開始,系統(tǒng)提供了內(nèi)置的事件注冊的快捷方法,你可以用下面的方式替代

namespace app\index\model;

use think\Model;

class User extends Model
{
    protected static function init()
    {
        User::beforeInsert(function ($user) {
            if ($user->status != 1) {
                return false;
            }
        });
    }
}

這些模型類的快捷方法如下:

標簽位 描述
beforeInsert 新增前
afterInsert 新增后
beforeUpdate 更新前
afterUpdate 更新后
beforeWrite 寫入前
afterWrite 寫入后
beforeDelete 刪除前
afterDelete 刪除后

文檔最后更新時間:2018-04-26 10:09:15

文檔
目錄

深色
模式

切換
寬度