Laravel Query Builder多条件查询：用when替代if-else实现whereBetween

嘿，我来帮你搞定这个查询构建的问题！用when()方法替代一堆if-else确实能让代码整洁很多，而且完美适配你需要的单条件、多条件组合查询场景。下面直接上解决方案和细节解释：

完整控制器代码实现 #

public function jobSearch(Request $request)
{
    // 初始化查询：筛选软删除且is_trash=1的数据
    $query = Job::onlyTrashed()
        ->where('is_trash', 1);

    // 1. 处理日期范围查询（whereBetween）
    $query->when(
        // 判断条件：是否同时提供了开始和结束日期
        $request->has(['start_date', 'end_date']),
        function ($q) use ($request) {
            // 注意替换成你实际的日期字段，比如job_date、created_at等
            $q->whereBetween('created_at', [$request->start_date, $request->end_date]);
        }
    );

    // 2. 处理用户名查询（支持精确匹配/模糊匹配）
    $query->when(
        // 判断条件：用户名参数非空
        $request->filled('username'),
        function ($q) use ($request) {
            // 精确匹配
            $q->where('username', $request->username);
            
            // 如果需要模糊搜索，替换成下面这行：
            // $q->where('username', 'like', "%{$request->username}%");
        }
    );

    // 3. 处理客户名查询（同理支持精确/模糊匹配）
    $query->when(
        $request->filled('customer_name'),
        function ($q) use ($request) {
            // 精确匹配
            $q->where('customer_name', $request->customer_name);
            
            // 模糊搜索版本：
            // $q->where('customer_name', 'like', "%{$request->customer_name}%");
        }
    );

    // 获取最终结果（可以根据需求改成paginate()等）
    $jobs = $query->get();

    return view('your-job-view', compact('jobs'));
}

关键细节解释 #

1. when()方法的核心优势 #

when()是Laravel Query Builder提供的语法糖，它的逻辑很简单：

• 第一个参数是布尔判断条件，如果为true，就执行第二个参数的闭包逻辑
• 如果条件不满足，直接跳过该部分查询，完全替代了繁琐的if-else嵌套

这样你的代码会更简洁、可读性更强，而且天然支持多条件的任意组合。

2. 日期范围的处理 #

用$request->has(['start_date', 'end_date'])来确保同时存在开始和结束日期，避免whereBetween因为缺少参数报错。如果你的日期字段不是created_at，记得替换成实际业务中使用的字段（比如job_date）。

3. 单条件与组合查询的自动支持 #

因为when()是链式调用的，所以：

• 只传日期参数 → 仅执行whereBetween
• 只传用户名 → 仅执行用户名的where
• 同时传日期+用户名 → 自动叠加两个条件，生成组合查询
• 其他组合（日期+客户名、仅客户名）同理，完全不需要额外判断

可选：添加请求验证（避免非法参数） #

为了让查询更健壮，可以在方法开头添加请求验证，确保参数格式合法：

$request->validate([
    'start_date' => 'nullable|date',
    'end_date' => 'nullable|date|after_or_equal:start_date',
    'username' => 'nullable|string',
    'customer_name' => 'nullable|string',
]);

这会自动验证日期格式，且保证结束日期不早于开始日期。

内容的提问来源于stack exchange，提问作者JsWizard