快捷查询

多字段相同查询条件的简化查询条件的写法，多个字段之间用|分割表示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语句

数组对象查询（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方法表示该查询条件两边会加上括号包起来。

使用数组对象查询的情况请一定要注意做好数据类型检查，尽量避免让用户决定你的数据。

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%' )

闭包查询

$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+）

通过调用一次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查询
whereExistsEXISTS条件查询
whereNotExistsNOT 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);});