## 快捷查询
快捷查询方式是**一种多字段相同查询条件**的简化写法，可以进一步简化查询条件的写法，在多个字段之间用`|`分割表示`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
~~~
> 快捷查询支持所有的查询表达式。
## 区间查询
区间查询是一种**同一字段多个查询条件**的简化写法，例如：
~~~php
Db::table('think_user')
->where('name', ['like', '%thinkphp%'], ['like', '%kancloud%'], 'or')
->where('id', ['>', 0], ['<>', 10], 'and')
->find();
~~~
生成的SQL语句为：
~~~sql
SELECT * FROM `think_user` WHERE ( `name` LIKE '%thinkphp%' OR `name` LIKE '%kancloud%' ) AND ( `id` > 0 AND `id` <> 10 ) LIMIT 1
~~~
> 区间查询的查询条件必须使用数组定义方式，支持所有的查询表达式。
下面的查询方式是错误的：
~~~php
Db::table('think_user')
->where('name', ['like', 'thinkphp%'], ['like', '%thinkphp'])
->where('id', 5, ['<>', 10], 'or')
->find();
~~~
区间查询其实可以用下面的方式替代，更容易理解，因为查询构造器支持对同一个字段多次调用查询条件，例如：
~~~php
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语句为：
~~~sql
SELECT * FROM `think_user` WHERE `name` LIKE 'thinkphp%' AND `title` LIKE '%thinkphp' AND `id` > 0 AND `status` = '1'
~~~
>[danger] 注意，`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();
~~~
>[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语句
## 数组对象查询（`V5.1.21+`）
对于习惯或者重度依赖数组查询条件的用户来说，可以选择数组对象查询，该对象完成了普通数组方式查询和系统的查询表达式之间的桥接，但**相较于系统推荐的查询表达式方方式而言，需要注意变量的安全性，避免产生SQL注入的情况**。
使用方法如下：
~~~
use think\db\Where;
$map = [
'name' => ['like', 'thinkphp%'],
'title' => ['like', '%think%'],
'id' => ['>', 10],
'status' => 1,
];
$where = new Where;
$where['id'] = ['in', [1, 2, 3]];
$where['title'] = ['like', '%php%'];
Db::table('think_user')
->where(new Where($map))
->whereOr($where->enclose())
->select();
~~~
`enclose`方法表示该查询条件两边会加上括号包起来。
>[danger] 使用数组对象查询的情况请一定要注意做好数据类型检查，尽量避免让用户决定你的数据。
生成的SQL是：
~~~sql
SELECT * FROM `think_user` WHERE `name` LIKE 'thinkphp%' AND `title` LIKE '%think%' AND `id` > 10 AND `status` =1 OR ( `id` IN (1,2,3) AND `title` LIKE '%php%' )
~~~
## 闭包查询
~~~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] 可见每个闭包条件两边也会自动加上括号，但需要注意，使用闭包查询的时候不能使用`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语句是：
~~~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();
~~~
>[danger] 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);
});
~~~
- 序言
- 基础
- 安装
- 开发规范
- 目录结构
- 配置
- 架构
- 架构总览
- 入口文件
- URL访问
- 模块设计
- 命名空间
- 容器和依赖注入
- Facade
- 钩子和行为
- 中间件
- 路由
- 路由定义
- 变量规则
- 路由地址
- 闭包支持
- 路由参数
- 路由缓存
- 跨域请求
- 注解路由
- 路由分组
- MISS路由
- 资源路由
- 快捷路由
- 路由别名
- 路由绑定
- 域名路由
- URL生成
- 控制器
- 控制器定义
- 前置操作
- 跳转和重定向
- 空操作和空控制器
- 分层控制器
- 资源控制器
- 控制器中间件
- 请求
- 请求对象
- 请求信息
- 输入变量
- 请求类型
- HTTP头信息
- 伪静态
- 参数绑定
- 请求缓存
- 响应
- 响应输出
- 响应参数
- 重定向
- 文件下载
- 数据库
- 连接数据库
- 查询构造器
- 查询数据
- 添加数据
- 更新数据
- 删除数据
- 查询表达式
- 链式操作
- where
- table
- alias
- field
- strict
- limit
- page
- order
- group
- having
- join
- union
- distinct
- lock
- cache
- comment
- fetchSql
- force
- partition
- failException
- sequence
- 聚合查询
- 时间查询
- 高级查询
- 视图查询
- JSON字段
- 子查询
- 原生查询
- 查询事件
- 获取器
- 事务操作
- 监听SQL
- 存储过程
- 数据集
- 分布式数据库
- 模型
- 定义
- 新增
- 更新
- 删除
- 查询
- JSON字段
- 获取器
- 修改器
- 搜索器
- 数据集
- 自动时间戳
- 只读字段
- 软删除
- 类型转换
- 数据完成
- 查询范围
- 模型输出
- 模型事件
- 模型关联
- 一对一关联
- 一对多关联
- 远程一对多
- 多对多关联
- 多态关联
- 关联预载入
- 关联统计
- 关联输出
- 视图
- 视图渲染
- 视图赋值
- 视图过滤
- 模板引擎
- 模板
- 变量输出
- 使用函数
- 运算符
- 原样输出
- 模板注释
- 模板布局
- 模板继承
- 包含文件
- 输出替换
- 标签库
- 内置标签
- 循环标签
- 比较标签
- 条件判断
- 资源文件加载
- 标签嵌套
- 原生PHP
- 定义标签
- 标签扩展
- 错误和日志
- 异常处理
- 日志处理
- 调试
- 调试模式
- Trace调试
- 性能调试
- SQL调试
- 变量调试
- 远程调试
- 验证
- 验证器
- 验证规则
- 错误信息
- 验证场景
- 路由验证
- 内置规则
- 独立验证
- 静态调用
- 表单令牌
- 杂项
- 缓存
- Session
- Cookie
- 多语言
- 分页
- 上传
- 命令行
- 启动内置服务器
- 查看版本
- 自动生成目录结构
- 创建类库文件
- 生成类库映射文件
- 清除缓存文件
- 生成配置缓存文件
- 生成数据表字段缓存
- 生成路由映射缓存
- 输出路由定义
- 自定义指令
- 扩展库
- 验证码
- 图像处理
- Time
- 数据库迁移工具
- Swoole
- Workerman
- MongoDb
- 单元测试
- 安全和性能
- 安全建议
- 优化建议
- 附录
- 助手函数
- 升级指导
- 更新日志