快捷查询
多字段相同查询条件的简化查询条件的写法,多个字段之间用|
分割表示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查询 |
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);});
千年的回眸
$result = model('表名称')
->where('idcard','exp','REGEXP \''."^{$idcardStart}\.{4}{$idcardEnd}$".'\'')
->select();
模式 描述
^ 匹配字符串开始位置,如设置RegExp 对象Multiline 属性,^ 也匹配 '\n' 或 '\r' 之后的位置,
$ 匹配字符串结束位置,如设置RegExp 对象的 Multiline 属性,$ 也匹配 '\n' 或 '\r' 之前的位置,
. 匹配除 "\n" 外的任何单个字符,要匹配包括 '\n' 在内的任何字符,用象 '[.\n]' 的模式,
[...] 字符集合,匹配所包含的任意一个字符, '[abc]' 可以匹配 "plain" 中的 'a',
[^...] 负值字符集合,匹配未包含的任意字符, '[^abc]' 可以匹配 "plain" 中的'p',
p1|p2|p3 匹配 p1 或 p2 或 p3,'z|food' 能匹配 "z" 或 "food",'(z|f)ood' 则匹配 "zood" 或 "food",
* 匹配前面的子表达式零次或多次,zo* 能匹配 "z" 以及 "zoo",* 等价于{0,},
+ 匹配前面的子表达式一次或多次,'zo+' 能匹配 "zo" 以及 "zoo",但不能匹配 "z",+ 等价于 {1,},
{n} n 是一个非负整数,匹配确定的 n 次,'o{2}' 不匹配 "Bob" 中的 'o',但匹配 "food" 中的两个 o,
{n,m} m 和 n 均为非负整数,其中n <= m,最少匹配 n 次且最多匹配 m 次,