## 模型事件 | 版本 | 新增功能 | | --- | --- | | 5.0.4 | 增加模型事件注冊快捷方法 | 模型事件是指在進行模型的寫入操作的時候觸發的操作行為，包括模型的save方法和delete方法。 > 模型事件只可以在調用模型的方法才能生效，使用查詢構造器通過Db類操作是無效的 模型類支持`before_delete`、`after_delete`、`before_write`、`after_write`、`before_update`、`after_update`、`before_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; } }); ~~~ 注冊的回調方法支持傳入一個參數（當前的模型對象實例），并且`before_write`、`before_insert`、`before_update`、`before_delete`事件方法如果返回false，則不會繼續執行。 支持給一個位置注冊多個回調方法，例如： ~~~ User::event('before_insert', function ($user) { if ($user->status != 1) { return false; } }); // 注冊回調到beforeInsert函數 User::event('before_insert', 'beforeInsert'); ~~~ 可以在模型類的init方法里面統一注冊模型事件，例如： ~~~ 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; } }); } } ~~~ > 調用當前模型也可以寫入 self::event('before\_insert', ...) ## 快捷注冊（`V5.0.4+`） V5.0.4+版本開始，系統提供了內置的事件注冊的快捷方法，你可以用下面的方式替代 ~~~ 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 | 刪除后 |