Laravel 系列：orWhere 条件式(thinkphp可做参考)

Laravel，一个优雅的 PHP 框架，也是目前最火的 PHP 项目，其生态积极健康，社区也很活跃。

目前我对于学习 Laravel 还是有些吃力的，基本方法都能很快掌握，但是一旦遇到了比较复杂的问题后，想要去查看源码进行调试的时候，总是会显得不知所措。   官方文档不会把所有方法都讲一遍，也不会把方法的各个使用场景都描述一遍，所以遇到这些问题去看文档一般解决不了。

改正一下，针对我下面这个问题，其实文档中有，是自己没有看仔细，不好意思啦：传送门

这次我遇到的问题是 orWhere 条件式造成的查询语句写法始终不是自己想要的。

场景描述

我需要根据商品分类、商品名称和条形码这三个查询条件去取出结果集，这三者的关系是：商品分类 and (商品名称 or 条形码)

错误尝试

第一次写出来的代码是这样的：

$goodsModel = new Goods;

if (!empty($category)) {
    $goodsModel = $goodsModel->where('category', $category);
}

if (!empty($keyword)) {
    $goodsModel = $goodsModel->where('name', 'like', "%{$keyword}%")->orWhere('barcode', 'like', "%{$keyword}%");
}

$goodsList = $goodsModel->limit(10)->get();

然后会发现这样的写法会导致三者的关系变成了：商品分类 and 商品名称 or 条形码。  

谷歌一下

也是找了一会才找到，如果需要将 or 两边的查询项作为一组查询条件，那么建议使用 where 的闭包方式。

闭包

这种方式将 or 部分写成 closure 传入 where()，与 Eloquent 风格一致，可读性较好。代码如下：

if (!empty($keyword)) {
    $goodsModel = $goodsModel->where(function ($query) use ($keyword) {
        $query->where('name', 'like', "%{$keyword}%")->orWhere('barcode', 'like', "%{$keyword}%");
    });
}

原生

实在想不出怎么写，就写原生 SQL 好了。这也是最后一种保险但不提倡的做法了吧，代码如下：

if (!empty($keyword)) {
    $keyword = "%{$keyword}%";
    $goodsModel = $goodsModel->whereRaw('(name like ? or barcode like ?)', [$keyword, $keyword]);
}

需要注意的是，单引号里面的括号是不能省略的，否则一样会导致这三者的关系是：商品分类 and 商品名称 or 条形码。

占位符

再友情提示一下，你可能会对 like ? 觉得奇怪，我第一次写的时候直接是 whereRaw('name like "%?%"', [$keyword]')，但是这样是没效果的，原因是占位符是对某一个完整的值进行占位，而不是简单的替换效果，所以需要将 like 的参数全部用 ? 替代，将百分号的拼接放在后面的占位数组的变量中去。  

参考链接：How do you parameterize whereRaw() in the query builder?