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?
