Laravel查询条件：AND与OR使用技巧

还在为 Laravel 查询中 AND 和 OR 条件的混淆而烦恼吗？尤其是在多字段模糊搜索时，错误的条件组合可能导致数据遗漏。本文深入剖析 Laravel 查询构建器的行为，着重讲解如何利用嵌套的 `where` 闭包，巧妙地将 AND 和 OR 逻辑进行组合，确保查询按预期执行。通过本文，你将学会如何构建更灵活、更精确的 Laravel 数据检索语句，避免常见的数据遗漏问题，提升 Laravel 应用的查询效率，让数据检索更加精准高效。掌握 Laravel 查询技巧，从容应对复杂搜索需求。

1. 理解 Laravel 查询中的 AND 与 OR

在 Laravel 的查询构建器中，当我们使用 where 方法并传入一个条件数组时，默认情况下，数组中的所有条件都会通过 AND 逻辑进行组合。例如，以下 Laravel 代码：

$entrys = t_e_elem::where([
    ['t_e_elem.fuse', '=', 1],
    ['t_entry.etitle', 'ilike', $title],
    ['t_entry.edesc','ilike',$title]
]);

会被 Laravel 转换为类似于这样的 SQL 语句：

SELECT * FROM `t_e_elems`
WHERE (`t_e_elem`.`fuse` = ? AND `t_entry`.`etitle` ILIKE ? AND `t_entry`.`edesc` ILIKE ?)

可以看到，t_entry.etitle 和 t_entry.edesc 两个条件之间也是 AND 关系。这意味着只有当 etitle 和 edesc 同时匹配 $title 时，记录才会被返回。这在许多搜索场景中并不符合预期，通常我们希望搜索条件是“标题包含 $title 或者 描述包含 $title”。

2. 正确实现 OR 逻辑：使用嵌套 where 闭包

为了在 Laravel 查询中实现 OR 逻辑，特别是当 OR 条件需要与其他 AND 条件组合时，我们需要使用嵌套的 where 闭包。这种方法允许我们创建一个独立的条件组，该组内部的条件可以按照 OR 逻辑进行组合，而整个组又会与外部的其他条件通过 AND 逻辑连接。

例如，如果我们的目标 SQL 是：

SELECT * FROM `users`
WHERE `t_e_elem`.`fuse` = ? AND (`t_entry`.`etitle` ILIKE ? OR `t_entry`.`edesc` ILIKE ?)

在 Laravel 中，可以通过以下方式实现：

t_e_elem::where('t_e_elem.fuse', '=', 1)
    ->where(function ($query) use ($title) {
        $query->where('t_entry.etitle', 'ilike', $title)
              ->orWhere('t_entry.edesc', 'ilike', $title);
    });

在这个例子中：

• where('t_e_elem.fuse', '=', 1) 是一个独立的 AND 条件。
• where(function ($query) use ($title) { ... }) 创建了一个子查询（或称条件组）。
• 在子查询内部，$query->where(...) 和 $query->orWhere(...) 实现了 etitle 和 edesc 之间的 OR 逻辑。
• 最终，外部的 AND 条件会与整个 OR 条件组进行组合。

3. 将 OR 逻辑应用于复杂查询

现在，我们将上述 OR 逻辑集成到原始的复杂查询中，以正确地根据标题或描述进行数据筛选，并按省份统计。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\t_data_enum; // 假设模型路径
use App\Models\t_e_elem;
use App\Models\t_entry;
use App\Models\t_e_value;
use App\Models\t_entry_form;

class EntryController extends Controller
{
    public function getTotalEntryByTitle($title)
    {
        $total = [];

        // 获取所有省份数据
        $provinces = t_data_enum::where('ekey', 'province')->orderBy('etext', 'ASC')->get();

        // 获取省份字段的form ID
        $formIdP = t_entry_form::where([['etype', 1], ['fname', 'field_province']])->first()->fid;

        foreach ($provinces as $province) {
            $entrysQuery = t_e_elem::selectRaw('t_entry.*, t_e_elem.*')
                ->join('t_entry', 't_e_elem.eid', '=', 't_entry.eid')
                ->join('t_e_value', 't_e_elem.fid', '=', 't_e_value.elid')
                ->join('t_entry_form', 't_e_value.fid', '=', 't_entry_form.fid')
                ->where('t_e_elem.fuse', '=', 1)
                ->where('t_entry.estatus', '1')
                // 核心改动：使用嵌套闭包实现标题或描述的OR搜索
                ->where(function ($query) use ($title) {
                    $query->where('t_entry.etitle', 'ilike', $title)
                          ->orWhere('t_entry.edesc', 'ilike', $title);
                })
                ->where([
                    ['t_e_value.fid', '=', $formIdP],
                    ['t_e_value.vvalue', '=', $province->eval],
                    // 注意：t_e_elem.fuse = 1 已经提前定义，这里如果重复且无特殊意义可移除
                    // 但为了保持原意，如果这里指代的是 t_e_value 相关的 fuse，则应明确
                    // 假设这里是冗余，因为 t_e_elem.fuse 已经在上面定义
                ]);

            // 使用 distinct 防止重复计数，并获取结果
            $entrys = $entrysQuery->distinct('t_entry.eid')->get();

            array_push($total, [
                'name' => $province->etext,
                'count' => count($entrys)
            ]);
        }

        return $total;
    }
}

代码解析与注意事项：

1. 统一 OR 条件: 最重要的改动是将 ['t_entry.etitle', 'ilike', $title], ['t_entry.edesc','ilike',$title] 这两个条件从 where 数组中移除，并放入一个 where(function ($query) use ($title) { ... }) 闭包中，通过 orWhere 方法连接。
2. 避免重复条件: 原始代码中在多个 where 子句中重复出现了 ['t_e_elem.fuse', '=', 1] 和 ['t_entry.etitle','ilike',$title], ['t_entry.edesc','ilike',$title]。在修改后的代码中，我们已经将 t_e_elem.fuse = 1 放在了查询链的早期，并且将 etitle 和 edesc 的 OR 条件统一处理。这样可以使查询更简洁、高效。
3. distinct 的位置: distinct("t_entry.eid") 用于确保每个唯一的 t_entry.eid 只被计数一次，这对于避免因 join 操作可能引入的重复行非常重要。它应该在 get() 之前调用。
4. ilike 操作符: ilike 是 PostgreSQL 特有的不区分大小写的模糊匹配操作符。如果使用的是 MySQL 或其他数据库，应使用 LIKE 配合 LOWER() 函数，或者在配置中设置不区分大小写排序规则。
5. 模型引用: 示例代码中假设了 t_data_enum、t_e_elem、t_entry、t_e_value 和 t_entry_form 都是正确的 Eloquent 模型，并且已正确导入。

4. 总结

正确理解和使用 Laravel 查询构建器中的 AND 和 OR 逻辑是构建高效、准确查询的关键。当需要在一个查询中组合多种条件，尤其是涉及到多字段模糊搜索时，利用嵌套的 where 闭包是最佳实践。它不仅能确保生成的 SQL 语句符合预期，还能使代码结构更清晰、易于维护。始终检查生成的 SQL 语句（例如，通过 toSql() 方法或 Laravel Debugbar）是验证查询逻辑是否正确执行的有效手段。

到这里，我们也就讲完了《Laravel查询条件：AND与OR使用技巧》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！