脦氓隆壟虜茅脩爐脫茂脩脭 · tp5文檔

# 快速入門（五）：查詢語言本章帶你領略`ThinkPHP5.0`的查詢語法，以及如何使用查詢構建器進行查詢操作，主要包括： - - [查詢表達式](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#u67E5u8BE2u8868u8FBEu5F0F) - [批量查詢](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#u6279u91CFu67E5u8BE2) - [快捷查詢](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#u5FEBu6377u67E5u8BE2) - [視圖查詢](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#u89C6u56FEu67E5u8BE2) - [閉包查詢](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#u95EDu5305u67E5u8BE2) - [使用Query對象](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#-query-) - [獲取數值](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#u83B7u53D6u6570u503C) - [獲取列數據](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#u83B7u53D6u5217u6570u636E) - [聚合查詢](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#u805Au5408u67E5u8BE2) - [字符串查詢](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#u5B57u7B26u4E32u67E5u8BE2) - [時間（日期）查詢](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#--3) - [分塊查詢](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147280#u5206u5757u67E5u8BE2) > 本章查詢內容均配置了數據表前綴`think_`，因此統一使用`Db`類的`name`方法代替`table`方法進行舉例說明。 ## 查詢表達式最普通的查詢就是判斷某個字段是否等于某個值，例如，我們查詢`think_data`數據表中`id`等于1的數據，用法如下： ``` <pre class="calibre18"> ``` $result = Db::name('data') ->where('id', 1) ->find(); dump($result); ``` ``` 新手注意，如果沒有使用`use`引入`Db`類的話需要使用： ``` <pre class="calibre18"> ``` $result = \think\Db::name('data') ->where('id', 1) ->find(); dump($result); ``` ``` > #### 提示： > > - - - - - - > > `find`方法用于查找滿足條件第一個記錄（即使你的查詢條件有多個符合的數據），如果查詢成功，返回的是一個一維數組，沒有滿足條件的話則默認返回`null`（也支持設置是否拋出異常）。生成的SQL語句是： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE `id` = 1 ``` ``` 上述的查詢其實等同于： ``` <pre class="calibre18"> ``` $result = Db::name('data') ->where('id', '=', 1) ->find(); dump($result); ``` ``` 使用表達式查詢的時候，where方法的參數依次為： > #### where( 字段名，條件表達式，查詢值 ) 可以支持的查詢表達式包括如下：表達式含義 EQ、= 等于（=） NEQ、<> 不等于（<>） GT、> 大于（>） EGT、>= 大于等于（>=） LT、< 小于（<） ELT、<= 小于等于（<=） LIKE 模糊查詢 \[NOT\] BETWEEN （不在）區間查詢 \[NOT\] IN （不在）IN 查詢 \[NOT\] NULL 查詢字段是否（不）是NULL \[NOT\] EXISTS EXISTS查詢 EXP 表達式查詢，支持SQL語法> 其中條件表達式不區分大小寫下面就來查詢`id`大于等于1的數據，使用如下代碼： ``` <pre class="calibre18"> ``` $result = Db::name('data') ->where('id', '>=', 1) ->limit(10) ->select(); dump($result); ``` ``` 因為這里需要返回多條記錄，因此這里我們使用了`select`方法，并且使用`limit`方法限制了返回的最多記錄數。 > #### 提示： > > - - - - - - > > `select`方法用于查詢數據集，如果查詢成功，返回的是一個二維數組，如果沒有滿足條件的話則返回空數組（也支持設置是否需要拋出異常）。生成的SQL語句是： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE `id` >= 1 LIMIT 10 ``` ``` 如果使用EXP條件表達式的話，表示后面是原生的SQL語句表達式，例如上面的查詢可以改成： ``` <pre class="calibre18"> ``` $result = Db::name('data') ->where('id', 'exp', '>= 1') ->limit(10) ->select(); dump($result); ``` ``` 生成的SQL語句和前面是一樣的。如果要查詢id的范圍，可以使用 ``` <pre class="calibre18"> ``` $result = Db::name('data') // id 是 1、2、3 其中的數字 ->where('id', 'in', [1, 2, 3]) ->select(); dump($result); ``` ``` 生成的SQL語句是： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE `id` IN (1,2,3) ``` ``` 或者 ``` <pre class="calibre18"> ``` $result = Db::name('data') // id 在 5到8之間的 ->where('id', 'between', [5, 8]) ->select(); dump($result); ``` ``` 生成的SQL語句是： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE `id` BETWEEN 5 AND 8 ``` ``` 接下來，使用多個字段查詢： ``` <pre class="calibre18"> ``` $result = Db::name('data') // id 在 1到3之間的 ->where('id', 'between', [1, 3]) // name 中包含think ->where('name', 'like', '%think%') ->select(); dump($result); ``` ``` 這樣生成的查詢語句為： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE `id` BETWEEN 1 AND 3 AND `name` LIKE '%think%' ``` ``` 如果要查詢某個字段是否為`NULL`，可以使用： ``` <pre class="calibre18"> ``` $result = Db::name('data') ->where('name', 'null') ->select(); dump($result); ``` ``` 這樣生成的查詢語句為： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE `name` IS NULL ``` ``` ## 批量查詢我們可以使用一個方法完成多個查詢條件，例如上面的查詢可以改成： ``` <pre class="calibre18"> ``` $result = Db::name('data') ->where([ 'id' => ['between', '1,3'], 'name' => ['like', '%think%'], ])->select(); dump($result); ``` ``` 這樣生成的查詢語句還是和之前一樣： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE `id` BETWEEN '1' AND '3' AND `name` LIKE '%think%' ``` ``` 我們再來看一些復雜的用法，使用`OR`和`AND`混合條件查詢，例如： ``` <pre class="calibre18"> ``` $result = Db::name('data') // name 中包含think ->where('name', 'like', '%think%') ->where('id', ['in', [1, 2, 3]], ['between', '5,8'], 'or') ->limit(10) ->select(); dump($result); ``` ``` 或者使用批量方式： ``` <pre class="calibre18"> ``` $result = Db::name('data') ->where([ 'id' => [['in', [1, 2, 3]], ['between', '5,8'], 'or'], 'name' => ['like', '%think%'], ])->limit(10)->select(); dump($result); ``` ``` 生成的SQL語句為： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE ( `id` IN (1,2,3) or `id` BETWEEN '5' AND '8' ) AND `name` LIKE '%think%' LIMIT 10 ``` ``` ## 快捷查詢如果你有多個字段需要使用相同的查詢條件，可以使用快捷查詢。例如，我們要查詢id和status都大于0的數據，可以使用： ``` <pre class="calibre18"> ``` $result = Db::name('data') ->where('id&status', '>', 0) ->limit(10) ->select(); dump($result); ``` ``` 生成的SQL語句為： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE ( `id` > 0 AND `status` > 0 ) LIMIT 10 ``` ``` 也可以使用or方式查詢，例如： ``` <pre class="calibre18"> ``` $result = Db::name('data') ->where('id|status', '>', 0) ->limit(10) ->select(); dump($result); ``` ``` 生成的SQL語句為： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE ( `id` > 0 OR `status` > 0 ) LIMIT 10 ``` ``` ## 視圖查詢如果需要快捷查詢多個表的數據，可以使用視圖查詢，相當于在數據庫創建了一個視圖，但僅僅支持查詢操作，例如： ``` <pre class="calibre18"> ``` $result = Db::view('user','id,name,status') ->view('profile',['name'=>'truename','phone','email'],'profile.user_id=user.id') ->where('status',1) ->order('id desc') ->select(); dump($result); ``` ``` 生成的SQL語句為： ``` <pre class="calibre18"> ``` SELECT user.id,user.name,user.status,profile.name AS truename,profile.phone,profile.email FROM think_user user INNER JOIN think_profile profile ON profile.user_id=user.id WHERE user.status = 1 order by user.id desc ``` ``` ## 閉包查詢 `find`和`select`方法可以直接使用閉包查詢： ``` <pre class="calibre18"> ``` $result = Db::name('data')->select(function ($query) { $query->where('name', 'like', '%think%') ->where('id', 'in', '1,2,3') ->limit(10); }); dump($result); ``` ``` 生成的SQL語句是： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE `name` LIKE '%think%' AND `id` IN ('1','2','3') LIMIT 10 ``` ``` ## 使用Query對象也可以事先封裝Query對象，并傳入select方法，例如： ``` <pre class="calibre18"> ``` $query = new \think\db\Query; $query->name('city')->where('name', 'like', '%think%') ->where('id', 'in', '1,2,3') ->limit(10); $result = Db::select($query); dump($result); ``` ``` 使用`Query`對象的話，`select`方法之前調用的任何的鏈式操作都是無效。 ## 獲取數值如果僅僅是需要獲取某行表的某個值，可以使用`value`方法： ``` <pre class="calibre18"> ``` // 獲取id為8的data數據的name字段值$name = Db::name('data') ->where('id', 8) ->value('name'); dump($name); ``` ``` name的結果為：`thinkphp` ## 獲取列數據也支持獲取某個列的數據，使用`column`方法，例如： ``` <pre class="calibre18"> ``` // 獲取data表的name列$list = Db::name('data') ->where('status', 1) ->column('name'); dump($list); ``` ``` 返回的結果類似下面： ``` <pre class="calibre18"> ``` array (size=5) 0 => string 'thinkphp'1 => string 'onethink'2 => string 'topthink'3 => string 'kancloud' ``` ``` 如果希望返回以id為索引的name列數據，可以改成： ``` <pre class="calibre18"> ``` // 獲取data表的name列并且以id為索引$list = Db::name('data') ->where('status', 1) ->column('name', 'id'); dump($list); ``` ``` 返回的結果類似下面： ``` <pre class="calibre18"> ``` array (size=5) 1 => string 'thinkphp'2 => string 'onethink'3 => string 'topthink'4 => string 'kancloud' ``` ``` 如果需要返回以主鍵為索引的數據集，可以使用： ``` <pre class="calibre18"> ``` // 獲取data表的name列并且以id為索引$list = Db::name('data') ->where('status', 1) ->column('*', 'id'); dump($list); ``` ``` 返回的結果類似下面： ``` <pre class="calibre18"> ``` array (size=5) 1 => array (size=3) 'id' => int 1'name' => string 'thinkphp''status'=> int 12 => array (size=3) 'id' => int 1'name' => string 'onethink''status'=> int 13 => array (size=3) 'id' => int 1'name' => string 'topthink''status'=> int 14 => array (size=3) 'id' => int 1'name' => string 'kancloud''status'=> int 1 ``` ``` ## 聚合查詢 thinkphp為聚合查詢提供了更便捷的方法，如下： ``` <pre class="calibre18"> ``` // 統計data表的數據$count = Db::name('data') ->where('status', 1) ->count(); dump($count); // 統計user表的最高分$max = Db::name('user') ->where('status', 1) ->max('score'); dump($max); ``` ``` 支持的聚合查詢方法包括：方法說明參數 count 統計數量統計的字段名（可選） max 獲取最大值統計的字段名（必須） min 獲取最小值統計的字段名（必須） avg 獲取平均值統計的字段名（必須） sum 獲取總分統計的字段名（必須）## 字符串查詢在必要的時候，仍然可以使用原生的字符串查詢，但建議是**配合參數綁定**一起使用，可以避免注入問題，例如： ``` <pre class="calibre18"> ``` $result = Db::name('data') ->where('id > :id AND name IS NOT NULL', ['id' => 10]) ->select(); dump($result); ``` ``` 可以直接在`where`方法中使用字符串查詢條件，并支持第二個參數傳入參數綁定，上面這個查詢生成的SQL語句是： ``` <pre class="calibre18"> ``` SELECT * FROM `think_data` WHERE ( id > '10' AND name IS NOT NULL ) ``` ``` ## 時間（日期）查詢 > 首先需要在`think_data`數據表新增`create_time`字段，用于日期查詢的字段類型推薦使用`datetime`類型。 `ThinkPHP5.0`的查詢語言強化了對時間日期查詢的支持，例如： ``` <pre class="calibre18"> ``` // 查詢創建時間大于2016-1-1的數據$result = Db::name('data') ->whereTime('create_time', '>', '2016-1-1') ->select(); dump($result); // 查詢本周添加的數據$result = Db::name('data') ->whereTime('create_time', '>', 'this week') ->select(); dump($result); // 查詢最近兩天添加的數據$result = Db::name('data') ->whereTime('create_time', '>', '-2 days') ->select(); dump($result); // 查詢創建時間在2016-1-1~2016-7-1的數據$result = Db::name('data') ->whereTime('create_time', 'between', ['2016-1-1', '2016-7-1']) ->select(); dump($result); ``` ``` 日期查詢對`create_time`字段類型沒有要求，可以是`int/string/timestamp/datetime/date`中的任何一種，系統會自動識別進行處理。還可以使用下面的人性化日期查詢方式，例如： ``` <pre class="calibre18"> ``` // 獲取今天的數據$result = Db::name('data') ->whereTime('create_time', 'today') ->select(); dump($result); // 獲取昨天的數據$result = Db::name('data') ->whereTime('create_time', 'yesterday') ->select(); dump($result); // 獲取本周的數據$result = Db::name('data') ->whereTime('create_time', 'week') ->select(); dump($result); // 獲取上周的數據$result = Db::name('data') ->whereTime('create_time', 'last week') ->select(); dump($result); ``` ``` ## 分塊查詢分塊查詢是為查詢大量數據的需要而設計的，假如`think_data`表已經有超過1萬條記錄，但是一次性取那么大的數據會導致內存開銷非常之大，但確實又有這個需要（例如查詢所有的數據并導出到`excel`），采用分塊查詢可以緩解這個問題。使用分塊查詢，可以把1萬條記錄分成`100`次處理，每次處理`100`條記錄，代碼示例如下： ``` <pre class="calibre18"> ``` Db::name('data') ->where('status', '>', 0) ->chunk(100, function ($list) { // 處理100條記錄foreach($list as $data){ } }); ``` ``` 第二個參數可以是有效的`callback`類型，包括使用閉包函數。系統會按照主鍵順序查詢，每次查詢`100`條，如果你不希望使用主鍵進行查詢，或者沒有主鍵的話，則需要指定查詢的排序字段（但必須是唯一的），例如： ``` <pre class="calibre18"> ``` Db::name('user') ->where('status', '>', 0) ->chunk(100, function ($list) { // 處理100條記錄foreach($list as $data){ } }, 'uid'); ``` ``` 然后交給`callback`進行數據處理，處理完畢后繼續查詢下一個`100`條記錄，如果你需要在中途中斷后續的查詢，只需要在`callback`方法調用中返回`false`即可，例如： ``` <pre class="calibre42"> ``` Db::name('data') ->where('status','>',0) ->chunk(100,function($list){ foreach($list as $data){ // 返回false則中斷后續查詢return false; } }); ``` ```