企业🤖AI Agent构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
## 查询范围 对于一些常用的查询条件,我们可以事先定义好,以便快速调用,这个事先定义的查询条件方法有一个统一的前缀`scope`,我们称之为查询范围,例如下面给`User`模型定义了两个查询范围方法。 ~~~php <?php namespace app\model; use think\Model; class User extends Model { public function scopeThinkphp($query) { $query->where('name','thinkphp')->field('id,name'); } public function scopeAge($query) { $query->where('age','>',20)->limit(10); } } ~~~ 就可以进行下面的条件查询: ~~~ // 查找name为thinkphp的用户 User::scope('thinkphp')->find(); // 查找年龄大于20的10个用户 User::scope('age')->select(); // 查找name为thinkphp的用户并且年龄大于20的10个用户 User::scope('thinkphp,age')->select(); ~~~ 查询范围的方法可以定义额外的参数,例如`User`模型类定义如下: ~~~ <?php namespace app\model; use think\Model; class User extends Model { public function scopeEmail($query, $email) { $query->where('email', 'like', '%' . $email . '%'); } public function scopeScore($query, $score) { $query->where('score', '>', $score); } } ~~~ 在查询的时候可以如下使用: ~~~ // 查询email包含thinkphp和分数大于80的用户 User::email('thinkphp')->score(80)->select(); ~~~ 可以直接使用闭包函数进行查询,例如: ~~~ User::scope(function($query){ $query->where('age','>',20)->limit(10); })->select(); ~~~ >[danger] 使用查询范围后,只能使用`find`或者`select`查询。 ## 全局查询范围 支持在模型里面设置`globalScope`属性,定义全局的查询范围 ~~~ <?php namespace app\model; use think\Model; class User extends Model { // 定义全局的查询范围 protected $globalScope = ['status']; public function scopeStatus($query) { $query->where('status',1); } } ~~~ 然后,执行下面的代码: ~~~ $user = User::find(1); ~~~ 最终的查询条件会是 ~~~ status = 1 AND id = 1 ~~~ 如果需要动态关闭所有的全局查询范围,可以使用: ~~~ // 关闭全局查询范围 User::withoutGlobalScope()->select(); ~~~ 可以使用`withoutGlobalScope`方法动态关闭部分全局查询范围。 ``` User::withoutGlobalScope(['status'])->select(); ```