在laravel eloquent中处理多层嵌套关系的数据过滤是一个常见的需求，尤其是在构建具有层级结构（如分类-子分类-产品）的应用时。当用户希望根据最深层级（例如产品）的条件进行搜索，并期望结果能够完整地展示其所属的父级（子分类和分类），同时又只包含那些与搜索条件匹配的子项时，标准的`wherehas`或简单的`with`方法往往无法满足要求。本文将深入探讨如何优雅地解决这一问题，确保数据在加载时即被精确过滤，并保持清晰的层级结构。
假设我们有以下三个模型及其关联关系：
我们的目标是根据产品的名称或货号进行搜索，并期望得到类似以下的层级结构输出：
Category1
- Subcategory1
- Product1 (匹配搜索条件)
Category2
- Subcategory3
- Product4 (匹配搜索条件)初次尝试时，开发者可能会使用whereHas来过滤顶层Categories：
<?php
use App\Models\Category; // 假设模型路径
$searchQuery = $request->search;
$categories = Category::whereHas('subcategories', function ($q) use ($searchQuery) {
$q->whereHas('products', function ($q) use ($searchQuery) {
$q->where('name', 'LIKE', "%{$searchQuery}%")
->orWhere('article_number', 'LIKE', "%{$searchQuery}%");
});
})->get();
?>这段代码能够正确地过滤出那些“包含符合搜索条件产品的分类”。然而，它只过滤了顶层Category，当通过$category-youjiankuohaophpcnsubcategories访问时，其关联的subcategories和products将是未经过滤的完整集合。这意味着，即使某个Category下只有一个Subcategory包含匹配的产品，但所有Subcategory及其所有Product都会被加载，这与我们的期望不符。
要实现既过滤父级又过滤子级，同时保持层级结构，我们需要将搜索条件重复应用于whereHas子句（用于过滤父级）和with子句（用于过滤急切加载的子级）。关键在于在with方法的闭包中，不仅要加载更深层的关系，还要对当前层级的关系应用whereHas进行过滤。
以下是实现这一目标的完整代码示例：
<?php
use App\Models\Category;
use Illuminate\Http\Request; // 假设 $request 是一个 Request 实例
// 模拟一个 Request 对象，实际应用中会从路由或控制器传入
$request = new Request(['search' => 'Product1']);
$searchQuery = $request->search;
$categories = Category::whereHas('subcategories', function ($q) use ($searchQuery) {
// 确保只选择包含匹配产品的子分类
$q->whereHas('products', function ($q) use ($searchQuery) {
$q->where('name', 'LIKE', "%{$searchQuery}%")
->orWhere('article_number', 'LIKE', "%{$searchQuery}%");
});
})->with(['subcategories' => function ($q) use ($searchQuery) {
// 对于急切加载的 subcategories，再次过滤，确保只加载包含匹配产品的子分类
$q->whereHas('products', function ($q) use ($searchQuery) {
$q->where('name', 'LIKE', "%{$searchQuery}%")
->orWhere('article_number', 'LIKE', "%{$searchQuery}%");
})->with(['products' => function ($q) use ($searchQuery) {
// 对于急切加载的 products，直接过滤产品本身
$q->where('name', 'LIKE', "%{$searchQuery}%")
->orWhere('article_number', 'LIKE', "%{$searchQuery}%");
}]);
}])->get();
// 此时 $categories 集合中的每个 Category 对象，
// 其 subcategories 属性将只包含那些包含匹配产品的子分类，
// 并且每个子分类的 products 属性也只包含匹配的产品。
// 示例输出（假设 Category, Subcategory, Product 都有 name 属性）
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) use ($searchQuery) { ... }]):
$q->whereHas('products', function ($q) use ($searchQuery) { ... }) (在 subcategories 的 with 闭包内):
->with(['products' => function ($q) use ($searchQuery) { ... }]) (在 subcategories 的 with 闭包内):
$q->where('name', 'LIKE', "%{$searchQuery}%")->orWhere('article_number', 'LIKE', "%{$searchQuery}%") (在 products 的 with 闭包内):
通过这种分层过滤的方式，我们能够精确控制每个层级的数据加载，从而获得一个干净、符合期望的层级结构数据集。
性能考量: 这种方法会生成相对复杂的SQL查询，包含多个EXISTS子句和LEFT JOIN（由whereHas和with转换而来）。对于非常大的数据集，应监控查询性能。在某些极端情况下，可能需要考虑使用原生SQL或数据库视图进行优化。
代码可读性与维护: 随着层级增多，闭包嵌套会变得复杂。可以考虑将重复的过滤逻辑封装到模型的作用域（scope）中，以提高代码的复用性和可读性。
// 在 Product 模型中
public function scopeSearch($query, $searchQuery)
{
return $query->where('name', 'LIKE', "%{$searchQuery}%")
->orWhere('article_number', 'LIKE', "%{$searchQuery}%");
}
// 在 Subcategory 模型中
public function scopeWithFilteredProducts($query, $searchQuery)
{
return $query->whereHas('products', function ($q) use ($searchQuery) {
$q->search($searchQuery);
})->with(['products' => function ($q) use ($searchQuery) {
$q->search($searchQuery);
}]);
}
// 在 Category 模型中
public function scopeWithFilteredSubcategories($query, $searchQuery)
{
return $query->whereHas('subcategories', function ($q) use ($searchQuery) {
$q->whereHas('products', function ($q) use ($searchQuery) { // 仍然需要这层 whereHas 来过滤 subcategories
$q->search($searchQuery);
});
})->with(['subcategories' => function ($q) use ($searchQuery) {
$q->withFilteredProducts($searchQuery); // 使用封装的 scope
}]);
}
// 调用时
$categories = Category::withFilteredSubcategories($searchQuery)->get();资源转换: 一旦获取到过滤后的$categories集合，可以使用Laravel的API资源（JsonResource）来进一步格式化输出，确保前端接收到的数据结构是清晰和一致的。
在Laravel Eloquent中，处理带有过滤条件的深度嵌套关系并保持层级结构是一个常见的挑战。通过巧妙地结合使用whereHas来过滤父级关系，并在with方法中使用闭包来对急切加载的子级关系进行进一步的whereHas和where过滤，我们可以有效地实现这一目标。这种方法不仅能够确保只加载符合条件的数据，还能避免出现空的中间层级，从而提供一个精确且结构完整的查询结果。理解并应用这种模式，将大大提升在复杂数据场景下使用Eloquent的效率和灵活性。
以上就是Laravel Eloquent：深度关联数据过滤与层级结构维护的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
356
收藏
