## 模型事件 模型事件是指在進行模型的查詢和寫入操作的時候觸發的操作行為。 >[danger] 模型事件只在調用模型的方法生效，使用查詢構造器操作是無效的 模型支持如下事件： |事件|描述|事件方法名| |---|---|---| |after_read | 查詢后 |onAfterRead| |before_insert | 新增前 |onBeforeInsert| |after_insert | 新增后 |onAfterInsert| |before_update | 更新前 |onBeforeUpdate| |after_update| 更新后 |onAfterUpdate| |before_write| 寫入前 |onBeforeWrite| |after_write | 寫入后 |onAfterWrite| |before_delete | 刪除前 |onBeforeDelete| |after_delete | 刪除后 |onAfterDelete| |before_restore | 恢復前 |onBeforeRestore| |after_restore | 恢復后 |onAfterRestore| 注冊的回調方法支持傳入一個參數（當前的模型對象實例），但支持依賴注入的方式增加額外參數。 >[info] 如果`before_write`、`before_insert`、 `before_update` 、`before_delete`事件方法中返回`false`或者拋出`think\exception\ModelEventException`異常的話，則不會繼續執行后續的操作。 ## 模型事件定義 最簡單的方式是在模型類里面定義靜態方法來定義模型的相關事件響應。 ~~~ <?php namespace app\model; use think\Model; use app\model\Profile; class User extends Model { public static function onBeforeUpdate($user) { if ('thinkphp' == $user->name) { return false; } } public static function onAfterDelete($user) { Profile::destroy($user->id); } } ~~~ 參數是當前的模型對象實例，支持使用依賴注入傳入更多的參數。 ## 寫入事件 `onBeforeWrite`和`onAfterWrite`事件會在`新增`操作和`更新`操作都會觸發. 具體的觸發順序: ``` // 執行 onBeforeWrite // 如果事件沒有返回`false`,那么繼續執行 // 執行新增或更新操作(onBeforeInsert/onAfterInsert或onBeforeUpdate/onAfterUpdate) // 新增或更新執行成功 // 執行 onAfterWrite ``` > 注意:模型的新增或更新是自動判斷的.