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(); ~~~