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

2020-09-10 14:51:40 浏览数 (1)

引言

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

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

学习时间

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

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

代码语言:javascript复制
$usersOfType = DB::table('users')->where('type', $type)->get();

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

代码语言:javascript复制
$emails = DB::table('contacts')->select('email', 'email2 as second_email')->get();

上面的查询语句,也可以这样写:

代码语言:javascript复制
$emails = DB::table('contacts')->select('email')->addSelect('email2 as second_email')->get();

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

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

代码语言:javascript复制
$newContacts = DB::table('contact')->where('created_at', '>', Carbon::now()->subDay())->get();

上面这是大小范围比较。

代码语言:javascript复制
$newVips = DB::table('contacts')->where('vip', 1)->where('created_at', '>', Carbon::now()->subDay());

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

代码语言:javascript复制
$newVips = DB::table('contacts')->where([['vip', 1],['created_at', '>', Carbon::now()->subDay()]]);

OR查询

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

代码语言:javascript复制
$priorityContacts = DB::table('contacts')->where('vip', 1)->orWhere('created_at', '>', Carbon::now()->subDay())->get();

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

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

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

代码语言:javascript复制
$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语句如下:

代码语言:javascript复制
select * from `contacts` where `vip` = 1 or (`created_at` > '2020-09-05 12:13:14' and `trial` = 0)

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

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

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

代码语言:javascript复制
$canEdit = DB::table('users')->where('admin', true)->orWhere('plan', 'premium')->where('is_plan_owner', true)->get();

这样生成的SQL语句如下:

代码语言:javascript复制
SELECT * FROM users WHERE admin = 1 OR plan = 'premium' AND is_plan_owner = 1;

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

代码语言:javascript复制
SELECT * FROM users WHERE admin = 1 OR (plan = 'premium' AND is_plan_owner = 1);

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

代码语言:javascript复制
$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 :-)

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

0 人点赞