本文详解如何在 laravel 中根据用户请求参数动态添加 where 条件，避免拼接 sql 字符串，实现安全、可维护、链式调用的查询构造。

本文详解如何在 laravel 中根据用户请求参数动态添加 where 条件，避免拼接 sql 字符串，实现安全、可维护、链式调用的查询构造。

在 Laravel 开发中，常需根据表单提交的筛选字段（如地址、状态、年龄等）动态向查询中追加 WHERE 条件。与原生 PHP 拼接 SQL 字符串（如 "$sql .= ' AND add1 '''"）不同，Laravel 提供了流畅、安全、可链式调用的查询构造器（Query Builder），支持运行时条件判断与条件注入，既防止 SQL 注入，又保持代码清晰可读。

以下是一个典型且健壮的实现方式：

✅ 正确做法：使用闭包或链式 where() 动态追加条件

use Illuminate\Support\Facades\DB;

// 初始化基础查询（注意：原问题中 DB::table() 语法有误，已修正）
$query = DB::table('users')
    ->join('user_infos', 'user_infos.user_id', '=', 'users.id')
    ->where('users.ustatus', '=', 1) // 替换原错误写法 'users', 'users.ustatus', '=', '1'
    ->select('users.*', 'user_infos.add1', 'user_infos.add3');

// ✅ 动态添加条件：仅当请求参数存在且非空时才加入 WHERE 子句
if ($request->filled('add_1')) {
    $query->where('user_infos.add1', '!=', '');
}

if ($request->filled('add_2')) {
    $query->where('user_infos.add2', '!=', '');
}

if ($request->filled('name')) {
    $query->where('users.name', 'like', "%{$request->name}%");
}

if ($request->filled('min_age')) {
    $query->where('users.age', '>=', (int)$request->min_age);
}

// 执行分页（注意：paginate() 必须在最终查询对象上调用）
$baseUsers = $query->paginate(3);

? 关键方法说明：

• $request->filled($key)：判断字段是否存在 且不为空字符串/空数组/null（比 has() 更严格，推荐用于表单筛选）；
• $request->has($key)：仅检查键是否存在（即使值为 '' 或 0 也会返回 true），适用于布尔型开关场景；
• 所有 where() 调用均返回 $query 实例，支持无限链式调用；
• 条件按需插入，未触发的 if 块完全不参与 SQL 构建，无冗余逻辑。

⚠️ 注意事项与最佳实践

• 切勿拼接原始 SQL：像 $sql .= " AND add1 != ''" 这类操作极易引发 SQL 注入，且破坏 Laravel 的查询安全机制（参数绑定失效）；
• 修正原始语法错误：DB::table('users', 'users.ustatus', '=', '1') 是非法调用，正确写法是 DB::table('users')->where('users.ustatus', 1)；
• 字段前缀需明确：多表 JOIN 时，WHERE 中的列名建议加上表别名（如 'user_infos.add1'），避免歧义；
• 空值处理要一致：若业务允许 NULL 地址，应使用 ->whereNotNull('user_infos.add1') 或 ->where('user_infos.add1', '!=', null)（注意：后者实际生成 IS NOT NULL）；
• 性能提示：对高频筛选字段（如 add1, name）建议添加数据库索引，尤其是 LIKE '%xxx%' 类模糊查询。

? 进阶技巧：使用 when() 方法简化条件逻辑（推荐）

Laravel 提供更优雅的 when() 高阶函数，使条件逻辑更声明式：

$baseUsers = DB::table('users')
    ->join('user_infos', 'user_infos.user_id', '=', 'users.id')
    ->where('users.ustatus', 1)
    ->select('users.*', 'user_infos.add1', 'user_infos.add3')
    ->when($request->filled('add_1'), function ($q) {
        return $q->where('user_infos.add1', '!=', '');
    })
    ->when($request->filled('add_2'), function ($q) {
        return $q->where('user_infos.add2', '!=', '');
    })
    ->when($request->filled('name'), function ($q) use ($request) {
        return $q->where('users.name', 'like', "%{$request->name}%");
    })
    ->paginate(3);

该写法将条件逻辑内聚在 when() 中，大幅提升可读性与可测试性，是 Laravel 官方推荐的现代写法。

掌握动态条件构建，不仅能写出更安全的代码，也是深入理解 Laravel Query Builder 设计哲学的关键一步。从今天起，告别字符串拼接，拥抱链式、可组合、可复用的查询构造模式。