可以对模型的查询和写入操作进行封装,例如:

  1. namespace app\index\model;
  2. use think\Model;
  3. class User extends Model
  4. {
  5. protected function scopeThinkphp($query)
  6. {
  7. $query->where('name','thinkphp')->field('id,name');
  8. }
  9. protected function scopeAge($query)
  10. {
  11. $query->where('age','>',20)->limit(10);
  12. }
  13. }

就可以进行下面的条件查询:

  1. // 查找name为thinkphp的用户
  2. User::scope('thinkphp')->find();
  3. // 查找年龄大于20的10个用户
  4. User::scope('age')->select();
  5. // 查找name为thinkphp的用户并且年龄大于20的10个用户
  6. User::scope('thinkphp,age')->select();

可以直接使用闭包函数进行查询,例如:

  1. User::scope(function($query){
  2. $query->where('age','>',20)->limit(10);
  3. })->select();

参数支持:

  1. namespace app\index\model;
  2. use think\Model;
  3. class User extends Model
  4. {
  5. protected function scopeAgeAbove($query, $lowest_age)
  6. {
  7. $query->where('age','>',$lowest_age)->limit(10);
  8. }
  9. }
  10. User::scope('ageAbove', 20)->select();
scope 的name 驼峰的 只能 ageAbove AgeAbove 不支持 age_above

支持动态调用的方式,例如:

  1. $user = new User;
  2. // 查找name为thinkphp的用户
  3. $user->thinkphp()->get();
  4. // 查找年龄大于20的10个用户
  5. $user->age()->all();
  6. // 查找name为thinkphp的用户并且年龄大于20的10个用户
  7. $user->thinkphp()->age()->all();
命名范围方法之前不能调用查询的连贯操作方法,必须首先被调用。如果在查询范围方法后面调用了其他的链式查询方法,则只能使用find或者select查询。

全局查询范围

如果你的所有查询都需要一个基础的查询范围,那么可以在模型类里面定义一个静态的base方法,例如:

  1. namespace app\index\model;
  2. use think\Model;
  3. class User extends Model
  4. {
  5. // 定义全局的查询范围
  6. protected function base($query)
  7. {
  8. $query->where('status',1);
  9. }
  10. }
全局查询范围方法在5.0.2版本之前必须定义为static静态方法。

然后,执行下面的代码:

  1. $user = User::get(1);

最终的查询条件会是

  1. status = 1 AND id = 1

如果需要动态关闭/开启全局查询访问,可以使用:

  1. // 关闭全局查询范围
  2. User::useGlobalScope(false)->get(1);
  3. // 开启全局查询范围
  4. User::useGlobalScope(true)->get(2);