攏簍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 ``` ``` 每次查詢都會自動帶上全局查詢范圍的查詢條件。