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