Where
最后更新于：2022-04-02 07:29:20
`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();
~~~
';