3分钟短文：Laravel模型OR查询避坑指南

引言

laravel模型提供了query builder对象用于组装查询条件并生成PSD查询语句，从而与数据库对话。如果使用and约束条件，这并不难写，无非是 A 成立且 B 成立且 C 成立，然后返回某某数据。

但是or查询往往有范围性，在原生SQL内可以使用括号，使其优先级同级，避免查询条件错乱。但是对于模型内组装的SQL，or条件其实用起来也是步步惊心的。本期我们通过一些例子，为大家提供避坑指南。

学习时间

为了方便起见，继续使用上一期的DB门面操作数据库，我们无需再贴出来定义好的Model对象了。这样可以节省很多空间。

常规的写法，比如只有一个约束条件的查询：

$usersOfType = DB::table('users')->where('type', $type)->get();

根据传入的$type，返回所有符合条件的数据条目。或者复杂一些的，指定返回的列，指定返回列名：

$emails = DB::table('contacts')->select('email', 'email2 as second_email')->get();

上面的查询语句，也可以这样写：

$emails = DB::table('contacts')->select('email')->addSelect('email2 as second_email')->get();

无非又是语法糖，方便记忆和阅读而已。效果是一样的。

为了演示多种用法，laravel的where查询子句，其实可以玩出花儿来，就多贴几种用法。

$newContacts = DB::table('contact')->where('created_at', '>', Carbon::now()->subDay())->get();

上面这是大小范围比较。

$newVips = DB::table('contacts')->where('vip', 1)->where('created_at', '>', Carbon::now()->subDay());

链式写法，还有同等写法，直接在where内传入约束条件的数组：

$newVips = DB::table('contacts')->where([['vip', 1],['created_at', '>', Carbon::now()->subDay()]]);

OR查询

说完and查询，我们把主要精力对准or查询的构造方法。说一个最简单的，比如查询出是vip，或者至少是一天之前注册的所有合约。那么只有两个查询条件，且互为or的关系。代码这样写：

$priorityContacts = DB::table('contacts')->where('vip', 1)->orWhere('created_at', '>', Carbon::now()->subDay())->get();

用一个orWhere连接即可。但是常常现实场景不会这么简单，往往都很复杂。比如执行下面的查询条件：

是vip会员
或者1天之前注册，且不是试用期

满足上述条件的合约都给查出来，用代码实现，要这么写：

$contacts = DB::table('contacts')
    ->where('vip', true)
    ->orWhere(function ($query) {
        $query->where('created_at', '>', Carbon::now()->subDay())
            ->where('trial', false);
    })
    ->get();

注意整个查询约束条件由2个组成，一个是vip，一个是1天前创建且不是试用期。上面代码生成的SQL语句如下：

select * from `contacts` where `vip` = 1 or (`created_at` > '2020-09-05 12:13:14' and `trial` = 0)

其中的括号限定有查询的优先级和分组。

为了加深大家的印象，举一个错误用法的例子，这个代码因为乱用了orWhere查询，导致生成的SQL语句虽然执行，却完全不在想象的空间内。

比如找出所有管理员，或者所有铂金用户且是其本人的所有记录。错误的写法如下：

$canEdit = DB::table('users')->where('admin', true)->orWhere('plan', 'premium')->where('is_plan_owner', true)->get();

这样生成的SQL语句如下：

SELECT * FROM users WHERE admin = 1 OR plan = 'premium' AND is_plan_owner = 1;

这个SQL语句限定的记录完全不上上面想要的约束条件。正确的SQL写法应该是这样的：

SELECT * FROM users WHERE admin = 1 OR (plan = 'premium' AND is_plan_owner = 1);

仿照之前的orWhere写法，我们需要在闭包内定义好字查询约束条件：

$canEdit = DB::table('users')
    ->where('admin', true)
    ->orWhere(function ($query) {
        $query->where('plan', 'premium')
            ->where('is_plan_owner', true);
    })
    ->get();

这样就可以了。

写在最后

本文重点通过where和orWhere查询子句的对比，为大家说明查询条件构造时一定要分清楚约束对象，以及连锁条件。生成的SQL语句最好使用getQueryLog函数，或者使用toSql方法打印最后的SQL语句，做到不错用方法，造成不必要的数据风险。

Happy coding :-)

我是@程序员小助手，持续分享编程知识，欢迎关注。