本文深入探讨了在 laravel eloquent 中如何高效地进行多级嵌套关联查询，并同时对各层级数据应用过滤条件。通过结合 `wherehas` 和带约束的 `with` 方法，我们能够精确检索符合特定条件的深层数据，同时确保返回的父级关联链不包含任何空节点，从而实现结构完整且过滤准确的数据集。
在构建复杂的Web应用程序时，数据库中往往存在多级关联关系，例如 Category 包含多个 Subcategory，而每个 Subcategory 又包含多个 Product。当我们需要根据最深层级（如 Product）的某个条件来检索数据，并且希望同时获取其完整的祖先链（Category -youjiankuohaophpcn Subcategory -> Product），同时确保返回的父级节点不包含任何不符合条件的子节点时，这就对查询的精确性提出了挑战。
例如，我们希望搜索名为 "Product1" 的产品，并得到如下结构：
Category1 - Subcategory1 - Product1
这意味着不仅要找到 "Product1"，还要找到包含 "Product1" 的 "Subcategory1"，以及包含 "Subcategory1" 的 "Category1"。更重要的是，如果 "Subcategory1" 中还有其他不符合条件的产品，它们不应被加载；如果 "Category1" 中还有其他不符合条件的子分类，它们也不应被加载。
最初的尝试通常会使用 whereHas 方法来过滤顶层模型：
<?php
use App\Models\Category; // 假设模型路径
$Categories = Category::whereHas('subcategories', function ($q) use ($request) {
$q->whereHas('products', function ($q) use ($request) {
$q->where('name', 'LIKE', "%$request->search%")
->orWhere('article_number', 'LIKE', "%$request->search%");
});
})->get();
?>这段代码能够成功过滤出那些包含符合搜索条件的产品的 Category。然而，它的局限性在于，虽然顶层 Category 被过滤了，但通过 with 方法预加载的 Subcategory 和 Product 关系仍会加载该 Category 下的所有 Subcategory 及其所有 Product，而不会对这些关联数据进行过滤。这意味着，即使 Category 满足条件，其内部的 Subcategory 或 Product 列表可能仍然包含不符合搜索条件的项，甚至可能包含空的 Subcategory 列表（如果 Category 下的所有 Subcategory 都不符合条件）。
例如，如果 Category1 有 Subcategory1 (含 Product1) 和 Subcategory2 (含 Product5)，上述查询只会返回 Category1，但如果后续使用 with('subcategories.products')，Subcategory2 及其 Product5 也会被加载，这并非我们所期望的精确过滤。
要实现精确过滤，并确保返回的关联链中没有“空”的父级或不相关的子级，我们需要在顶层查询中使用 whereHas 进行初步筛选，并在 with 方法中对每个关联关系再次应用过滤条件，包括嵌套的 whereHas。
以下是实现这一目标的完整解决方案代码：
<?php
use App\Models\Category;
use Illuminate\Http\Request; // 假设 $request 是一个 Request 实例
// 模拟请求对象
$request = new Request(['search' => 'Product1']);
$Categories = Category::whereHas('subcategories', function ($q) use ($request) {
// 1. 过滤顶层 Category：确保 Category 至少包含一个符合条件的 Subcategory
$q->whereHas('products', function ($q) use ($request) {
// 确保 Subcategory 至少包含一个符合条件的 Product
$q->where('name', 'LIKE', "%{$request->search}%")
->orWhere('article_number', 'LIKE', "%{$request->search}%");
});
})->with(['subcategories' => function ($q) use ($request) {
// 2. 预加载并过滤 Subcategory：确保只加载那些包含符合条件的 Product 的 Subcategory
$q->whereHas('products', function ($q) use ($request) {
$q->where('name', 'LIKE', "%{$request->search}%")
->orWhere('article_number', 'LIKE', "%{$request->search}%");
})->with(['products' => function ($q) use ($request) {
// 3. 预加载并过滤 Product：确保只加载符合条件的 Product
$q->where('name', 'LIKE', "%{$request->search}%")
->orWhere('article_number', 'LIKE', "%{$request->search}%");
}]);
}])->get();
// 打印结果 (示例)
foreach ($Categories as $category) {
echo "Category: {$category->name}\n";
foreach ($category->subcategories as $subcategory) {
echo " Subcategory: {$subcategory->name}\n";
foreach ($subcategory->products as $product) {
echo " Product: {$product->name}\n";
}
}
}
?>顶层 whereHas('subcategories', ...):
with(['subcategories' => function ($q) { ... }]):
通过这种层层递进的 whereHas 和带约束的 with 组合，我们不仅能获取到符合条件的最终产品，还能确保其整个祖先链（Category 和 Subcategory）都是经过精确过滤的，不包含任何不相关的或空的节点。
理解 whereHas 和 with 约束之间的区别至关重要：
在我们的解决方案中，whereHas 用于确保顶层 Category 是相关的，而 with 内部的 whereHas 和 where 约束则用于确保预加载的 Subcategory 和 Product 也是经过精确过滤的，从而避免加载不必要的数据。
性能考量：虽然这种方法非常强大，但当数据量非常大或嵌套层级很深时，复杂的 whereHas 和 with 组合可能会导致性能下降。这是因为 Eloquent 会生成更复杂的 SQL 查询，可能涉及多个 JOIN 或子查询。
代码复用：如果搜索逻辑复杂且在多处重复，可以将其封装成 Eloquent 的局部作用域 (Local Scopes) 或自定义查询构建器方法，以提高代码的可读性和可维护性。
// 在 Product 模型中定义局部作用域
public function scopeSearch($query, $search)
{
return $query->where('name', 'LIKE', "%{$search}%")
->orWhere('article_number', 'LIKE', "%{$search}%");
}
// 然后在查询中使用
$q->whereHas('products', function ($q) use ($request) {
$q->search($request->search);
});
// ...以此类推条件动态性：当搜索条件来自用户输入时，务必进行适当的验证和参数绑定（Eloquent 默认会处理），以防止 SQL 注入攻击。
Laravel Eloquent 提供了强大且灵活的 API 来处理复杂的数据库关联查询。通过巧妙地结合 whereHas 方法进行顶层过滤，并利用带约束的 with 方法对多级关联关系进行精确的数据过滤，我们能够高效地检索出结构完整、内容准确的嵌套数据集。这种方法不仅满足了业务需求，也避免了加载不必要的冗余数据，是处理复杂关联查询的专业实践。
以上就是Laravel Eloquent 深度关联查询与数据过滤实战的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
318
收藏
