## 快捷查詢
快捷查詢方式是**一種多字段相同查詢條件**的簡化寫法，可以進一步簡化查詢條件的寫法，在多個字段之間用`|`分割表示`OR`查詢，用`&`分割表示`AND`查詢，可以實現下面的查詢，例如：
~~~php
Db::table('think_user')
->where('name|title','like','thinkphp%')
->where('create_time&update_time','>',0)
->find();
~~~
生成的查詢SQL是：
~~~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%'],
['title', 'like', '%thinkphp'],
['id', '>', 0],
['status', '=', 1],
])
->select();
~~~
生成的SQL語句為：
~~~sql
SELECT * FROM `think_user` WHERE `name` LIKE 'thinkphp%' AND `title` LIKE '%thinkphp' AND `id` > 0 AND `status` = '1'
~~~
數組方式如果使用`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();
~~~
>[danger] 注意，相同的字段的多次查詢條件可能會合并，如果希望某一個`where`方法里面的條件單獨處理，可以使用下面的方式，避免被其它條件影響。
~~~php
$map = [
['name', 'like', 'thinkphp%'],
['title', 'like', '%thinkphp'],
['id', '>', 0],
];
Db::table('think_user')
->where([ $map ])
->where('status',1)
->select();
~~~
生成的SQL語句為：
~~~sql
SELECT * FROM `think_user` WHERE ( `name` LIKE 'thinkphp%' AND `title` LIKE '%thinkphp' AND `id` > 0 ) AND `status` = '1'
~~~
如果使用下面的多個條件組合
~~~php
$map1 = [
['name', 'like', 'thinkphp%'],
['title', 'like', '%thinkphp'],
];
$map2 = [
['name', 'like', 'kancloud%'],
['title', 'like', '%kancloud'],
];
Db::table('think_user')
->whereOr([ $map1, $map2 ])
->select();
~~~
生成的SQL語句為：
~~~sql
SELECT * FROM `think_user` WHERE ( `name` LIKE 'thinkphp%' AND `title` LIKE '%thinkphp' ) OR ( `name` LIKE 'kancloud%' AND `title` LIKE '%kancloud' )
~~~
> 善用多維數組查詢，可以很方便的拼裝出各種復雜的SQL語句
## 閉包查詢
~~~php
$name = 'thinkphp';
$id = 10;
Db::table('think_user')->where(function ($query) use($name, $id) {
$query->where('name', $name)
->whereOr('id', '>', $id);
})->select();
~~~
生成的SQL語句為：
~~~sql
SELECT * FROM `think_user` WHERE ( `name` = 'thinkphp' OR `id` > 10 )
~~~
>[danger] 每個閉包條件兩邊也會自動加上括號。
## 字符串條件查詢
也可以直接使用原生SQL語句進行查詢，例如：
~~~
Db::table('think_user')
->whereRaw('id > 0 AND name LIKE "thinkphp%"')
->select();
~~~
為了安全起見，我們可以對字符串查詢條件使用參數綁定，例如：
~~~
Db::table('think_user')
->whereRaw('id > :id AND name LIKE :name ', ['id' => 0, 'name' => '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();
~~~
支持數組方式比較多個字段
~~~
Db::name('user')->whereColumn([
['title', '=', 'name'],
['update_time', '>=', 'create_time'],
])->select();
~~~
生成的SQL語句是：
~~~
SELECT * FROM `think_user` WHERE ( `name` = `nickname` AND `update_time` > `create_time` )
~~~
## 動態查詢
查詢構造器還提供了動態查詢機制，用于簡化查詢條件，包括：
| 動態查詢 | 描述 |
| --- | --- |
|`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`方法只會查詢一條記錄，可以和其它的鏈式方法搭配使用
## 條件查詢
查詢構造器支持條件查詢，例如：
~~~
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);
});
~~~
- 簡介
- 數據庫配置
- 分布式數據庫
- 查詢構造器
- 查詢數據
- 新增數據
- 更新數據
- 刪除數據
- 鏈式操作
- Where
- Table
- Alias
- Field
- Strict
- Limit
- Page
- Order
- Group
- Having
- Join
- Union
- Distinct
- Lock
- Cache
- Comment
- FetchSql
- Force
- Partition
- Replace
- FailException
- Extra
- Duplicate
- Sequence
- Procedure
- View
- 聚合查詢
- 分頁查詢
- 時間查詢
- 高級查詢
- 子查詢
- 原生查詢
- 事務操作
- 存儲過程
- 查詢事件
- JSON字段
- 模型
- 定義
- 新增
- 更新
- 刪除
- 查詢
- 查詢范圍
- 只讀字段
- JSON字段
- 自動時間寫入
- 獲取器
- 修改器
- 搜索器
- 類型轉換
- 模型輸出
- 模型事件
- 虛擬模型
- 關聯
- 一對一關聯
- 一對多關聯
- 遠程一對多
- 遠程一對一
- 多對多關聯
- 多態一對多
- 多態一對一
- 關聯預載入
- 關聯統計
- 關聯輸出
- SQL監聽
- 緩存機制
- 字段緩存
- 查詢緩存
- 擴展
- 自定義查詢類
- 自定義數據庫驅動