模型事件

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

模型事件是指在进行模型的写入操作的时候触发的操作行为,包括模型的save方法和delete方法。

模型事件只可以在调用模型的方法才能生效,使用查询构造器通过Db类操作是无效的

模型类支持before_deleteafter_deletebefore_writeafter_writebefore_updateafter_updatebefore_insertafter_insert事件行为

标签位描述
before_insert新增前
after_insert新增后
before_update更新前
after_update更新后
before_write写入前
after_write写入后
before_delete删除前
after_delete删除后

使用方法如下:

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

注册的回调方法支持传入一个参数(当前的模型对象实例),并且before_writebefore_insertbefore_updatebefore_delete事件方法如果返回false,则不会继续执行。

支持给一个位置注册多个回调方法,例如:

  1. User::event('before_insert', function ($user) {
  2. if ($user->status != 1) {
  3. return false;
  4. }
  5. });
  6. // 注册回调到beforeInsert函数
  7. User::event('before_insert', 'beforeInsert');

可以在模型类的init方法里面统一注册模型事件,例如:

  1. namespace app\index\model;
  2. use think\Model;
  3. class User extends Model
  4. {
  5. protected static function init()
  6. {
  7. User::event('before_insert', function ($user) {
  8. if ($user->status != 1) {
  9. return false;
  10. }
  11. });
  12. }
  13. }
调用当前模型也可以写入 self::event('before_insert', …)

快捷注册(V5.0.4+)

V5.0.4+版本开始,系统提供了内置的事件注册的快捷方法,你可以用下面的方式替代

  1. namespace app\index\model;
  2. use think\Model;
  3. class User extends Model
  4. {
  5. protected static function init()
  6. {
  7. User::beforeInsert(function ($user) {
  8. if ($user->status != 1) {
  9. return false;
  10. }
  11. });
  12. }
  13. }

这些模型类的快捷方法如下:

标签位描述
beforeInsert新增前
afterInsert新增后
beforeUpdate更新前
afterUpdate更新后
beforeWrite写入前
afterWrite写入后
beforeDelete删除前
afterDelete删除后