拢篓5拢漏虏茅脩炉路露脦搂 · tp5文档

## 查询范围对于一些常用的查询条件，我们可以封装成查询范围来进行方便的调用。例如，邮箱地址为`thinkphp@qq.com`和status为1这两个常用查询条件，可以定义为模型类的两个查询范围方法： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\model; use think\Model; class User extends Model{ // 定义类型转换protected $type = [ 'birthday' => 'timestamp:Y/m/d', ]; // 定义自动完成的属性protected $insert = ['status']; // status修改器protected function setStatusAttr($value, $data){ return '流年' == $data['nickname'] ? 1 : 2; } // status读取器protected function getStatusAttr($value){ $status = [-1 => '删除', 0 => '禁用', 1 => '正常', 2 => '待审核']; return $status[$value]; } // email查询protected function scopeEmail($query){ $query->where('email', 'thinkphp@qq.com'); } // status查询protected function scopeStatus($query){ $query->where('status', 1); } } ``` ``` 查询范围方法的定义规范为： > ### scope + 查询范围名称我们修改控制器的index方法如下： ``` <pre class="calibre18"> ``` // 根据查询范围获取用户数据列表public function index(){ $list = UserModel::scope('email,status')->all(); foreach ($list as $user) { echo $user->nickname . ' '; echo $user->email . ' '; echo $user->birthday . ' '; echo $user->status . ' '; echo '------------------------------------- '; } } ``` ``` 最后查询的SQL语句是： ``` <pre class="calibre18"> ``` SELECT * FROM `think_user` WHERE `email` = 'thinkphp@qq.com' AND `status` = 1 ``` ``` 支持多次调用`scope`方法，并且可以追加新的查询及链式操作，例如： ``` <pre class="calibre18"> ``` // 根据查询范围获取用户数据列表public function index(){ // $list = UserModel::scope('email') ->scope('status') ->scope(function ($query) { $query->order('id', 'desc'); }) ->all(); foreach ($list as $user) { echo $user->nickname . ' '; echo $user->email . ' '; echo $user->birthday . ' '; echo $user->status . ' '; echo '------------------------------------- '; } } ``` ``` 上面的scope方法使用了闭包，闭包里面支持所有的链式操作方法。最后生成的SQL语句是： ``` <pre class="calibre18"> ``` SELECT * FROM `think_user` WHERE `email` = 'thinkphp@qq.com' AND `status` = 1 ORDER BY `id` desc ``` ``` 查询范围方法支持额外的参数，例如`scopeEmail`方法改为： ``` <pre class="calibre18"> ``` // email查询protected function scopeEmail($query, $email = ''){ $query->where('email', $email); } ``` ``` > 查询范围的方法的第一个参数必须是查询对象，并且支持多个额外参数。然后，使用下面的方式调用即可： ``` <pre class="calibre18"> ``` $list = UserModel::scope('email','thinkphp@qq.com')->all(); ``` ``` ## 全局查询范围可以给模型定义全局的查询范围，在模型类添加一个静态的`base`方法即可，例如我们给模型类增加一个全局查询范围，用于查询状态为1的数据： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\model; use think\Model; class User extends Model{ // 定义类型转换protected $type = [ 'birthday' => 'timestamp:Y/m/d', ]; // 定义自动完成的属性protected $insert = ['status']; // status修改器protected function setStatusAttr($value, $data){ return '流年' == $data['nickname'] ? 1 : 2; } // status读取器protected function getStatusAttr($value){ $status = [-1 => '删除', 0 => '禁用', 1 => '正常', 2 => '待审核']; return $status[$value]; } // email查询protected function scopeEmail($query){ $query->where('email', 'thinkphp@qq.com'); } // 全局查询范围protected static function base($query){ // 查询状态为1的数据$query->where('status',1); } } ``` ``` 当使用下面的查询操作 ``` <pre class="calibre18"> ``` UserModel::scope('email')->all(); ``` ``` 最后生成的SQL语句是： ``` <pre class="calibre18"> ``` SELECT * FROM `think_user` WHERE `email` = 'thinkphp@qq.com' AND `status` = 1 ORDER BY `id` desc ``` ``` 每次查询都会自动带上全局查询范围的查询条件。