Where · ThinkORM开发指南

`where`方法在链式操作方法里面是最常用的方法，可以完成包括普通查询、表达式查询、快捷查询、区间查询、组合查询在内的条件查询操作。 `where`方法的用法很多，这里主要描述下最常用的表达式查询用法，更多的查询请参考[高级查询](%E9%AB%98%E7%BA%A7%E6%9F%A5%E8%AF%A2.md)章节及后续章节。 ## 表达式查询 >[danger] 表达式查询是官方推荐使用的查询方式查询表达式支持大部分的SQL查询语法，也是`ThinkORM`查询语言的精髓，查询表达式的使用格式： > where('字段名', '查询表达式', '查询条件'); 除了`where`方法外，还可以支持`whereOr`，用法是一样的。为了更加方便查询，大多数的查询表达式都提供了快捷查询方法。表达式不分大小写，支持的查询表达式有下面几种： | 表达式 | 含义 | 快捷查询方法 | | --- | --- | --- | | \= | 等于 | | | <> | 不等于 | | | \> | 大于 | | | \>= | 大于等于 | | | < | 小于 | | | <= | 小于等于 | | | \[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` | | find in set |FIND\_IN\_SET查询| `whereFindInSet` | 表达式查询的用法示例如下： ### 等于（=）例如： ~~~ 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(); ~~~ `whereLike`查询同样也支持使用数组 ~~~ Db::name('user')->whereLike('name', ['%think','php%'], 'OR')->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`查询支持使用闭包方式 ~~~ Db::name('user')->whereIn('id', function($query) { return $query->name('profile')->field('user_id')->where('score', '>', 80); })->select(); ~~~ ### \[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支持的语法，包括使用函数和字段名称。推荐使用`whereExp`方法查询 ~~~ Db::name('user')->whereExp('id', 'IN (1,3,8) ')->select(); ~~~