laravel多条件查询(Laravel多条件查询)

Laravel 多条件查询完全指南：从基础到高级实战

在 Web 开发中，数据查询是后端逻辑的核心环节。对于使用 Laravel 框架的开发者而言，Eloquent ORM 和 Query Builder 提供了强大且优雅的数据库操作方式。然而，当面临多条件动态筛选（如用户搜索、商品过滤、后台管理列表）时，如何编写高效、可读且安全的代码，往往是对开发者经验的考验。 本文将深入探讨 Laravel 中多条件查询的最佳实践，涵盖基础语法、动态条件构建、性能优化及常见陷阱，帮助你写出更专业的代码。

一、 基础回顾：Laravel 查询构建器 vs Eloquent

在深入多条件查询之前，我们需要明确两个核心工具的区别： 1. Query Builder：底层数据库抽象层，接近原生 SQL，适合复杂查询或不需要模型关联的场景。 2. Eloquent ORM：基于 ActiveRecord 模式，提供模型关联、访问器、事件等高级功能，适合大多数业务场景。 多条件查询通常结合使用两者：利用 Eloquent 进行模型定义和关联，利用 Query Builder 进行链式条件构建。

二、 核心方法：如何构建多条件查询

1. 链式调用（Chaining）

Laravel 查询构建器最强大的特性是链式调用。你可以无限次地调用 `where`、`orWhere`、`join` 等方法，最后通过 `get()` 或 `first()` 执行。 ```php $users = User::where('status', 'active') ->where('age', '>=', 18) ->where('role', 'admin') ->get(); ```

2. 动态条件构建

在实际业务中，用户输入的参数往往是可选的（例如：搜索框可能只填了“姓名”，也可能只选了“状态”）。硬编码所有条件会导致大量冗余代码。

方法一：条件判断包裹

```php $query = User::query(); if ($request->has('status')) { request->status); } if ($request->has('role')) { request->role); } if ($request->filled('name')) { request->name}%"); } query->get(); ```

方法二：使用 `when()` 方法（推荐）

Laravel 的 `when()` 方法是处理动态条件的利器。它仅在条件为真时才执行回调。 ```php request->status, function (status) { return status); }) ->when(query, $role) { return role); }) ->when(query, $name) { return name}%"); }) ->get(); ``` 优点：代码更简洁，逻辑更清晰，避免了大量的 `if-else` 嵌套。

3. 复杂条件组合：`where` 闭包

当需要处理 `(A AND B) OR C` 这种复杂逻辑时，可以使用闭包函数。 ```php query) use ($request) { // 内部条件为 AND 关系 request->category_id) ->where('price', '<', $request->max_price); }) ->orWhere('is_featured', true) // 外部条件为 OR 关系 ->get(); ``` 生成的 SQL 大致如下： ```sql SELECT FROM products WHERE (category_id = ? AND price < ?) OR is_featured = ? ```

三、 高级技巧与最佳实践

1. 使用作用域（Scopes）复用查询逻辑

如果多条件查询逻辑在多个地方使用，建议将其封装为 Eloquent 作用域。 ```php // 在 User 模型中定义 class User extends Model { public function scopeActive($query) { return $query->where('status', 'active'); } public function scopeWithRole(role) { return role); } public function scopeSearchName(name) { return name}%"); } } // 使用时 $users = User::active() ->withRole('admin') ->searchName($request->name) ->get(); ```

2. 性能优化：只查询需要的字段

多条件查询常用于列表展示，通常不需要获取所有字段。使用 `select()` 减少数据传输量。 ```php $users = User::where('status', 'active') ->select('id', 'name', 'email') // 只查必要字段 ->get(); ```

3. 分页与性能平衡

当数据量大时，务必使用分页。Laravel 的分页会自动处理 `LIMIT` 和 `OFFSET`。 ```php $users = User::where('status', 'active')->paginate(15); ``` 注意：在大数据量下，避免使用 `skip()` 和 `take()` 手动分页，因为深层分页会导致数据库性能急剧下降。

4. 防止 SQL 注入

虽然 Laravel 的查询构建器默认使用参数绑定（Parameter Binding），自动防止 SQL 注入，但在使用 `whereRaw()` 或 `orderByRaw()` 时需谨慎。 ```php // ❌ 危险：直接拼接用户输入 User::whereRaw("name = '{$request->name}'")->get(); // ✅ 安全：使用参数占位符 User::whereRaw('name = ?', [$request->name])->get(); ```

四、 常见陷阱与解决方案

问题	描述	解决方案
空值过滤	用户未选择某筛选条件时，`where` 可能误匹配空字符串	使用 `filled()` 或 `has()` 检查参数是否存在且非空
OR 逻辑错误	混合使用 `where` 和 `orWhere` 时，优先级可能导致逻辑错误	始终使用闭包包裹 `OR` 条件，确保括号正确
N+1 问题	在循环中查询关联数据	使用 `with()` 预加载关联模型，避免循环内查询
索引失效	对字段使用函数（如 `DATE(created_at)`）会导致索引失效	尽量直接比较字段值，或使用范围查询

五、 实战案例：电商商品筛选

假设我们有一个电商后台，需要支持按分类、价格区间、品牌、筛选商品。 ```php public function index(Request $request) { $query = Product::with(['category', 'brand']); // 预加载关联 // 1. 搜索（标题或描述） if ($request->filled('keyword')) { q) use ($request) { request->keyword}%") ->orWhere('description', 'like', "%{$request->keyword}%"); }); } // 2. 分类筛选 if ($request->filled('category_id')) { request->category_id); } // 3. 品牌筛选 if ($request->filled('brand_id')) { request->brand_id); } // 4. 价格区间 if ($request->filled('min_price')) { request->min_price); } if ($request->filled('max_price')) { request->max_price); } // 5. 排序 request->input('sort', 'created_at'); request->input('order', 'desc'); sortBy, $sortOrder); // 6. 分页 query->paginate(20); return view('products.index', compact('products')); } ``` 这段代码清晰、可维护，且易于扩展新的筛选条件。

六、 总结

Laravel 的多条件查询能力非常强大，关键在于合理使用链式调用、`when()` 方法和闭包。遵循以下原则，可以写出高质量查询代码： 1. 动态条件优先使用 `when()`，保持代码整洁。 2. 复杂逻辑使用闭包，确保 SQL 括号正确。 3. 始终注意性能：选择必要字段、预加载关联、合理使用分页和索引。 4. 安全第一：避免 `whereRaw` 直接拼接用户输入。 掌握这些技巧，你将能够轻松应对各种复杂的业务查询需求，构建高效、稳定的 Laravel 应用。