高級查詢 · thinkphp5

# 高級查詢 ## 快捷查詢快捷查詢方式是**一種多字段相同查詢條件**的簡化寫法，可以進一步簡化查詢條件的寫法，在多個字段之間用`|`分割表示`OR`查詢，用`&`分割表示`AND`查詢，可以實現下面的查詢，例如： ``` Db::table('think_user') ->where('name|title','like','thinkphp%') ->where('create_time&update_time','>',0) ->find(); ``` 生成的查詢SQL是： ``` SELECT * FROM `think_user` WHERE ( `name` LIKE 'thinkphp%' OR `title` LIKE 'thinkphp%' ) AND ( `create_time` > 0 AND `update_time` > 0 ) LIMIT 1 ``` > 快捷查詢支持所有的查詢表達式。 ## 區間查詢區間查詢是一種**同一字段多個查詢條件**的簡化寫法，例如： ``` Db::table('think_user') ->where('name', ['like', '%thinkphp%'], ['like', '%kancloud%'], 'or') ->where('id', ['>', 0], ['<>', 10], 'and') ->find(); ``` 生成的SQL語句為： ``` SELECT * FROM `think_user` WHERE ( `name` LIKE '%thinkphp%' OR `name` LIKE '%kancloud%' ) AND ( `id` > 0 AND `id` <> 10 ) LIMIT 1 ``` > 區間查詢的查詢條件必須使用數組定義方式，支持所有的查詢表達式。下面的查詢方式是錯誤的： ``` Db::table('think_user') ->where('name', ['like', 'thinkphp%'], ['like', '%thinkphp']) ->where('id', 5, ['<>', 10], 'or') ->find(); ``` 區間查詢其實可以用下面的方式替代，更容易理解，因為查詢構造器支持對同一個字段多次調用查詢條件，例如： ``` Db::table('think_user') ->where('name', 'like', '%think%') ->where('name', 'like', '%php%') ->where('id', 'in', [1, 5, 80, 50]) ->where('id', '>', 10) ->find(); ``` ## 批量（字段）查詢可以進行多個條件的批量條件查詢定義，例如： ``` Db::table('think_user') ->where([ ['name', 'like', 'thinkphp%'], ['title', 'like', '%thinkphp'], ['id', '>', 0], ['status', '=', 1], ]) ->select(); ``` 生成的SQL語句為： ``` SELECT * FROM `think_user` WHERE `name` LIKE 'thinkphp%' AND `title` LIKE '%thinkphp' AND `id` > 0 AND `status` = '1' ``` > 注意，`V5.1.7+`版本數組方式如果使用`exp`查詢的話，一定要用`raw`方法。 ``` Db::table('think_user') ->where([ ['name', 'like', 'thinkphp%'], ['title', 'like', '%thinkphp'], ['id', 'exp', Db::raw('>score')], ['status', '=', 1], ]) ->select(); ``` 數組查詢方式，確保你的查詢數組不能被用戶提交數據控制，用戶提交的表單數據應該是作為查詢數組的一個元素傳入，如下： ``` Db::table('think_user') ->where([ ['name', 'like', $name . '%'], ['title', 'like', '%' . $title], ['id', '>', $id], ['status', '=', $status], ]) ->select(); ``` > 注意，相同的字段的多次查詢條件可能會合并，如果希望某一個`where`方法里面的條件單獨處理，可以使用下面的方式，避免被其它條件影響。 ``` $map = [ ['name', 'like', 'thinkphp%'], ['title', 'like', '%thinkphp'], ['id', '>', 0], ]; Db::table('think_user') ->where([ $map ]) ->where('status',1) ->select(); ``` 生成的SQL語句為： ``` SELECT * FROM `think_user` WHERE ( `name` LIKE 'thinkphp%' AND `title` LIKE '%thinkphp' AND `id` > 0 ) AND `status` = '1' ``` 如果使用下面的多個條件組合 ``` $map1 = [ ['name', 'like', 'thinkphp%'], ['title', 'like', '%thinkphp'], ]; $map2 = [ ['name', 'like', 'kancloud%'], ['title', 'like', '%kancloud'], ]; Db::table('think_user') ->whereOr([ $map1, $map2 ]) ->select(); ``` 生成的SQL語句為： ``` SELECT * FROM `think_user` WHERE ( `name` LIKE 'thinkphp%' AND `title` LIKE '%thinkphp' ) OR ( `name` LIKE 'kancloud%' AND `title` LIKE '%kancloud' ) ``` > 善用多維數組查詢，可以很方便的拼裝出各種復雜的SQL語句 ## 閉包查詢 ``` $name = 'thinkphp'; $id = 10; Db::table('think_user')->where(function ($query) use($name, $id) { $query->where('name', $name) ->whereOr('id', '>', $id); })->select(); ``` 生成的SQL語句為： ``` SELECT * FROM `think_user` WHERE ( `name` = 'thinkphp' OR `id` > 10 ) ``` > 可見每個閉包條件兩邊也會自動加上括號，但需要注意，使用閉包查詢的時候不能使用`cache(true)`數據緩存，而應該使用指定key的方式例如`cache('key')`。 ## 混合查詢可以結合前面提到的所有方式進行混合查詢，例如： ``` Db::table('think_user') ->where('name', ['like', 'thinkphp%'], ['like', '%thinkphp']) ->where(function ($query) { $query->where('id', ['<', 10], ['>', 100], 'or'); }) ->select(); ``` 生成的SQL語句是： ``` SELECT * FROM `think_user` WHERE ( `name` LIKE 'thinkphp%' AND `name` LIKE '%thinkphp' ) AND ( `id` < 10 or `id` > 100 ) ``` ## 字符串條件查詢對于一些實在復雜的查詢，也可以直接使用原生SQL語句進行查詢，例如： ``` Db::table('think_user') ->where('id > 0 AND name LIKE "thinkphp%"') ->select(); ``` 為了安全起見，我們可以對字符串查詢條件使用參數綁定，例如： ``` Db::table('think_user') ->where('id > :id AND name LIKE :name ', ['id' => 0, 'name' => 'thinkphp%']) ->select(); ``` `V5.1.8+`版本開始，如果你要使用字符串條件查詢，推薦使用`whereRaw`方法。 ``` Db::table('think_user') ->whereRaw('id > :id AND name LIKE :name ', ['id' => 0, 'name' => 'thinkphp%']) ->select(); ``` ## 使用Query對象查詢（`V5.1.5+`） `V5.1.5+`版本開始，可以通過調用一次`where`方法傳入`Query`對象來進行查詢。 ``` $query = new \think\db\Query; $query->where('id','>',0) ->where('name','like','%thinkphp'); Db::table('think_user') ->where($query) ->select(); ``` > Query對象的`where`方法僅能調用一次，如果`query`對象里面使用了非查詢條件的鏈式方法，則不會傳入當前查詢。 ``` $query = new \think\db\Query; $query->where('id','>',0) ->where('name','like','%thinkphp') ->order('id','desc') // 不會傳入后面的查詢 ->field('name,id'); // 不會傳入后面的查詢 Db::table('think_user') ->where($query) ->where('title','like','thinkphp%') // 有效 ->select(); ``` ## 快捷方法系統封裝了一系列快捷方法，用于簡化查詢，包括：方法作用`whereOr`字段OR查詢`whereXor`字段XOR查詢`whereNull`查詢字段是否為Null`whereNotNull`查詢字段是否不為Null`whereIn`字段IN查詢`whereNotIn`字段NOT IN查詢`whereBetween`字段BETWEEN查詢`whereNotBetween`字段NOT BETWEEN查詢`whereLike`字段LIKE查詢`whereNotLike`字段NOT LIKE查詢`whereExists`EXISTS條件查詢`whereNotExists`NOT EXISTS條件查詢`whereExp`表達式查詢`whereColumn`比較兩個字段下面舉例說明下兩個字段比較的查詢條件`whereColumn`方法的用法。查詢`update_time`大于`create_time`的用戶數據 ``` Db::table('think_user') ->whereColumn('update_time','>','create_time') ->select(); ``` 生成的SQL語句是： ``` SELECT * FROM `think_user` WHERE ( `update_time` > `create_time` ) ``` 查詢`name`和`nickname`相同的用戶數據 ``` Db::table('think_user') ->whereColumn('name','=','nickname') ->select(); ``` 生成的SQL語句是： ``` SELECT * FROM `think_user` WHERE ( `name` = `nickname` ) ``` 相同字段條件也可以簡化為 ``` Db::table('think_user') ->whereColumn('name','nickname') ->select(); ``` `V5.1.11+`版本開始，支持數組方式比較多個字段 ``` Db::name('user')->whereColumn([ ['title', '=', 'name'], ['update_time', '>=', 'create_time'], ])->select(); ``` 生成的SQL語句是： ``` SELECT * FROM `think_user` WHERE ( `name` = `nickname` AND `update_time` > `create_time` ) ``` ## 動態查詢查詢構造器還提供了兩個動態查詢機制，用于簡化查詢條件，包括`getBy`和`getFieldBy`。動態查詢描述`whereFieldName`查詢某個字段的值`whereOrFieldName`查詢某個字段的值`getByFieldName`根據某個字段查詢`getFieldByFieldName`根據某個字段獲取某個值其中`FieldName`表示數據表的實際字段名稱的駝峰法表示，假設數據表`user`中有`email`和`nick_name`字段，我們可以這樣來查詢。 ``` // 根據郵箱（email）查詢用戶信息 $user = Db::table('user') ->whereEmail('thinkphp@qq.com') ->find(); // 根據昵稱（nick_name）查詢用戶 $email = Db::table('user') ->whereNickName('like', '%流年%') ->select(); // 根據郵箱查詢用戶信息 $user = Db::table('user') ->getByEmail('thinkphp@qq.com'); // 根據昵稱（nick_name）查詢用戶信息 $user = Db::table('user') ->field('id,name,nick_name,email') ->getByNickName('流年'); // 根據郵箱查詢用戶的昵稱 $nickname = Db::table('user') ->getFieldByEmail('thinkphp@qq.com', 'nick_name'); // 根據昵稱（nick_name）查詢用戶郵箱 $email = Db::table('user') ->getFieldByNickName('流年', 'email'); ``` > `getBy`和`getFieldBy`方法只會查詢一條記錄，可以和其它的鏈式方法搭配使用 ## 條件查詢 5\.1的查詢構造器支持條件查詢，例如： ``` Db::name('user')->when($condition, function ($query) { // 滿足條件后執行 $query->where('score', '>', 80)->limit(10); })->select(); ``` 并且支持不滿足條件的分支查詢 ``` Db::name('user')->when($condition, function ($query) { // 滿足條件后執行 $query->where('score', '>', 80)->limit(10); }, function ($query) { // 不滿足條件執行 $query->where('score', '>', 60); }); ```