查询表达式 · ThinkPHP5.1完全开发手册

## 查询表达式查询表达式支持大部分的SQL查询语法，也是`ThinkPHP`查询语言的精髓，查询表达式的使用格式： ~~~ where('字段名','表达式','查询条件'); whereOr('字段名','表达式','查询条件'); ~~~ `5.1`还支持新的查询方法 ~~~ whereField('表达式','查询条件'); whereOrField('表达式','查询条件'); ~~~ > `Field`使用字段的驼峰命名方式。表达式不分大小写，支持的查询表达式有下面几种： | 表达式 | 含义 | 快捷查询方法| | --- | --- | --- | | = | 等于 || | <> | 不等于 | | | > | 大于 | | | >= | 大于等于 | | | < | 小于 | | | <= | 小于等于 | | | [NOT] LIKE | 模糊查询 | `whereLike/whereNotLike` | | [NOT] BETWEEN | （不在）区间查询 | `whereBetween/whereNotBetween`| | [NOT] IN | （不在）IN 查询 | `whereIn/whereNotIn`| | [NOT] NULL | 查询字段是否（不）是NULL | `whereNull/whereNotNull` | | [NOT] EXISTS | EXISTS查询 | `whereExists/whereNotExists` | | [NOT] REGEXP | 正则（不）匹配查询（仅支持Mysql）|| | [NOT] BETWEEM TIME | 时间区间比较 | whereBetweenTime| | > TIME | 大于某个时间 |`whereTime` | | < TIME | 小于某个时间 | `whereTime`| | >= TIME | 大于等于某个时间 | `whereTime`| | <= TIME | 小于等于某个时间 | `whereTime`| | EXP | 表达式查询，支持SQL语法 | `whereExp` | 表达式查询的用法示例如下： ## 等于（=）例如： ~~~ Db::name('user')->where('id','=',100)->select(); ~~~ 和下面的查询等效 ~~~ Db::name('user')->where('id',100)->select(); ~~~ 最终生成的SQL语句是： ~~~ SELECT * FROM `think_user` WHERE `id` = 100 ~~~ ## 不等于（<>）例如： ~~~ Db::name('user')->where('id','<>',100)->select(); ~~~ 最终生成的SQL语句是： ~~~ SELECT * FROM `think_user` WHERE `id` <> 100 ~~~ ## 大于（>）例如： ~~~ Db::name('user')->where('id','>',100)->select(); ~~~ 最终生成的SQL语句是： ~~~ SELECT * FROM `think_user` WHERE `id` > 100 ~~~ ## 大于等于（>=）例如： ~~~ Db::name('user')->where('id','>=',100)->select(); ~~~ 最终生成的SQL语句是： ~~~ SELECT * FROM `think_user` WHERE `id` >= 100 ~~~ ## 小于（<）例如： ~~~ Db::name('user')->where('id','<',100)->select(); ~~~ 最终生成的SQL语句是： ~~~ SELECT * FROM `think_user` WHERE `id` < 100 ~~~ ## 小于等于（<=）例如： ~~~ Db::name('user')->where('id','<=',100)->select(); ~~~ 最终生成的SQL语句是： ~~~ SELECT * FROM `think_user` WHERE `id` <= 100 ~~~ ## [NOT] LIKE：同sql的LIKE 例如： ~~~ Db::name('user')->where('name','like','thinkphp%')->select(); ~~~ 最终生成的SQL语句是： ~~~ SELECT * FROM `think_user` WHERE `name` LIKE 'thinkphp%' ~~~ `like`查询支持使用数组 ~~~ Db::name('user')->where('name','like',['%think','php%'],'OR')->select(); ~~~ 实际生成的SQL语句为： ~~~ SELECT * FROM `think_user` WHERE (`name` LIKE '%think' OR `name` LIKE 'php%') ~~~ 为了更加方便，应该直接使用`whereLike`方法 ~~~ Db::name('user')->whereLike('name','thinkphp%')->select(); Db::name('user')->whereNotLike('name','thinkphp%')->select(); ~~~ ## [NOT] BETWEEN ：同sql的[not] between 查询条件支持字符串或者数组，例如： ~~~ Db::name('user')->where('id','between','1,8')->select(); ~~~ 和下面的等效： ~~~ Db::name('user')->where('id','between',[1,8])->select(); ~~~ 最终生成的SQL语句都是： ~~~ SELECT * FROM `think_user` WHERE `id` BETWEEN 1 AND 8 ~~~ 最快捷的查询方法是： ~~~ Db::name('user')->whereBetween('id','1,8')->select(); Db::name('user')->whereNotBetween('id','1,8')->select(); ~~~ ## [NOT] IN：同sql的[not] in 查询条件支持字符串或者数组，例如： ~~~ Db::name('user')->where('id','in','1,5,8')->select(); ~~~ 和下面的等效： ~~~ Db::name('user')->where('id','in',[1,5,8])->select(); ~~~ 最终的SQL语句为： ~~~ SELECT * FROM `think_user` WHERE `id` IN (1,5,8) ~~~ 最快捷的查询方法是： ~~~ Db::name('user')->whereIn('id','1,5,8')->select(); Db::name('user')->whereNotIn('id','1,5,8')->select(); ~~~ >[info] `[NOT] IN`查询支持使用闭包方式 ## [NOT] NULL ：查询字段是否（不）是`Null`，例如： ~~~ Db::name('user')->where('name', null) ->where('email','null') ->where('name','not null') ->select(); ~~~ 实际生成的SQL语句为： ~~~ SELECT * FROM `think_user` WHERE `name` IS NULL AND `email` IS NULL AND `name` IS NOT NULL ~~~ 如果你需要查询一个字段的值为字符串`null`或者`not null`，应该使用： ~~~ Db::name('user')->where('title','=', 'null') ->where('name','=', 'not null') ->select(); ~~~ 推荐的方式是使用`whereNull`和`whereNotNull`方法查询。 ~~~ Db::name('user')->whereNull('name') ->whereNull('email') ->whereNotNull('name') ->select(); ~~~ ## EXP：表达式支持更复杂的查询情况例如： ~~~ Db::name('user')->where('id','in','1,3,8')->select(); ~~~ 可以改成： ~~~ Db::name('user')->where('id','exp',' IN (1,3,8) ')->select(); ~~~ `exp`查询的条件不会被当成字符串，所以后面的查询条件可以使用任何SQL支持的语法，包括使用函数和字段名称。 ## 动态查询对于上面的查询表达式，可以使用动态查询方法进行简化，例如： ~~~ Db::name('user')->where('id','>=',100)->select(); ~~~ 可以简化为： ~~~ Db::name('user')->whereId('>=',100)->select(); ~~~