在Laravel项目开发中，Eloquent关联查询是非常常用的功能。很多时候我们需要查询主表数据的同时，根据子表的字段条件过滤数据，或者同时过滤主表和子表的数据，这时候就需要掌握正确的关联查询过滤方法。本文将围绕这一主题展开详细讨论，帮助开发者理清关联查询中父子表过滤的思路和技巧。
基础场景说明与模型关联定义
在实际开发中，关联查询的场景非常普遍。假设我们有一个电商系统，其中包含分类和商品两个核心实体。分类作为父表，商品作为子表，一个分类下可以包含多个商品，而每个商品都属于某一个分类。这种一对多的关系在Eloquent中通过hasMany和belongsTo方法来定义。理解模型之间的关联定义是掌握关联查询过滤的前提，只有正确地定义了模型间的关联关系，才能在查询时灵活运用各种过滤方法。
下面是两个模型的关联定义示例。在Category模型中，我们通过products方法定义了与Product模型的一对多关系；在Product模型中，我们通过category方法定义了反向的属于关系。这两个定义构成了后续所有关联查询过滤操作的基础。
<?php
namespace AppModels;
use IlluminateDatabaseEloquentModel;
use IlluminateDatabaseEloquentRelationsHasMany;
// 分类模型（父表）
class Category extends Model
{
// 定义分类和商品的一对多关联
public function products(): HasMany
{
return $this->hasMany(Product::class);
}
}
// 商品模型（子表）
class Product extends Model
{
// 定义商品所属分类的关联
public function category()
{
return $this->belongsTo(Category::class);
}
}
在上述代码中，Category模型通过hasMany方法关联到Product模型，表示一个分类下可以有多个商品。Product模型则通过belongsTo方法反向关联到Category模型，表示每个商品都属于一个分类。这种双向关联定义使得我们可以在查询时从任意一方出发，灵活地进行关联过滤操作。
同时过滤父子表数据的核心方法
方法一：whereHas过滤主表配合with过滤子表
当我们需要同时过滤父子表数据时，最常见的需求是：查询满足某些条件的主表记录，同时这些主表记录的子表数据也需要满足特定条件。例如，查询状态为启用的分类，同时要求这些分类下存在价格大于100的商品，并且在最终加载的商品数据中也只包含价格大于100的那些商品。这种需求需要同时使用whereHas和with两个方法来配合完成。
whereHas方法的作用是根据子表的条件来过滤主表数据，只有当主表关联的子表中存在满足条件的记录时，该主表记录才会被查询出来。然而，whereHas本身并不会限制子表数据的加载范围，也就是说，即使使用了whereHas过滤了主表，后续通过关联加载子表数据时仍然会加载所有关联的子表记录。因此，我们需要配合with方法的闭包来进一步过滤子表加载的数据，确保最终结果中不包含不符合条件的子表数据。
<?php
use AppModelsCategory;
// 查询启用的分类，同时加载价格大于100的商品
$categories = Category::where('status', 1) // 过滤主表：分类状态为启用
->whereHas('products', function ($query) {
// 过滤主表：仅保留子表中存在价格大于100的商品的分类
$query->where('price', '>', 100);
})
->with(['products' => function ($query) {
// 过滤子表加载：只加载价格大于100的商品，避免冗余数据
$query->where('price', '>', 100);
}])
->get();
// 遍历查询结果
foreach ($categories as $category) {
echo "分类名称：{$category->name}" . PHP_EOL;
foreach ($category->products as $product) {
echo "商品名称：{$product->name}，价格：{$product->price}" . PHP_EOL;
}
}
在上面的代码中，where('status', 1)负责过滤主表，只查询状态为启用的分类。whereHas方法进一步过滤主表，确保只有那些关联的商品中存在价格大于100的分类才会被保留。with方法的闭包则负责控制子表数据的加载范围，只加载价格大于100的商品记录。三者配合使用，才能实现父子表数据的同时过滤。需要注意的是，whereHas和with闭包中的过滤条件通常需要保持一致，这样才能确保查询结果的主表和子表数据都符合预期。
方法二：主表过滤与子表过滤分开处理
在某些场景下，主表的过滤条件与子表没有直接关联，此时可以将主表过滤条件单独写在查询构造器上，子表的过滤条件则放在with的闭包中处理。这种写法逻辑更加清晰，代码可读性也更好。同时，如果子表需要多个过滤条件，可以在同一个闭包中链式调用多个where方法来实现。
<?php
use AppModelsCategory;
// 主表过滤和子表过滤分开写，逻辑更清晰
$categories = Category::where('status', 1) // 主表过滤：状态为启用
->with(['products' => function ($query) {
// 子表过滤：价格大于100且库存大于0
$query->where('price', '>', 100)
->where('stock', '>', 0);
}])
->get();
// 遍历结果
foreach ($categories as $category) {
echo "分类：{$category->name}" . PHP_EOL;
foreach ($category->products as $product) {
echo " 商品：{$product->name}，价格：{$product->price}，库存：{$product->stock}" . PHP_EOL;
}
}
这种写法省去了whereHas的调用，直接在with闭包中过滤子表数据。需要注意的是，这种写法不会根据子表条件来过滤主表，也就是说，即使某个启用的分类下没有价格大于100且库存大于0的商品，该分类仍然会被查询出来，只是其products关联集合为空。如果需要排除这类没有满足条件子表数据的主表记录，仍然需要使用whereHas方法。
注意事项与常见问题解析
在使用Eloquent关联查询过滤父子表数据时，有几个关键点需要特别注意。首先，whereHas的作用是过滤主表数据，只有满足子表条件的主表记录才会被查询出来，但它不会自动过滤子表加载的数据。这意味着，如果你只使用了whereHas而没有在with中添加闭包过滤条件，那么通过关联访问子表数据时，仍然会加载所有关联的子表记录，包括那些不满足条件的记录。这是很多开发者容易踩坑的地方。
其次，如果业务需求只是过滤主表而不需要加载子表数据，那么可以只使用whereHas而不需要配合with。例如，只需要查询哪些分类下存在价格大于100的商品，但不需要实际加载这些商品数据，此时单独使用whereHas就足够了，这样可以减少不必要的数据库查询开销，提升性能。
另外，当关联层级比较深时，比如分类下有商品，商品又有订单记录，可以使用whereHas的嵌套写法来实现多层关联过滤。通过点号语法指定关联路径，例如whereHas('products.orders', function ($query) {...})，就可以基于深层关联的子表条件来过滤主表数据。这种嵌套写法在处理复杂业务逻辑时非常实用，但也要注意查询性能的影响，过深的嵌套可能导致SQL查询效率下降。
还有一个常见问题是：为什么使用了whereHas还是会加载所有子表数据？原因在于whereHas只负责过滤主表，它生成的SQL语句是在主表查询中添加了一个EXISTS子查询来判断子表是否存在满足条件的记录，但这个子查询并不会影响后续通过with加载子表数据时的查询条件。因此，必须搭配with的闭包条件才能过滤子表数据，避免加载不需要的关联数据。
最后，如果需要查询子表不存在某些记录的主表数据，可以使用whereDoesntHave方法。例如，查询没有商品的分类，这个方法与whereHas正好相反，用于过滤那些关联子表为空的主表记录。
<?php
use AppModelsCategory;
// 查询没有商品的分类
$emptyCategories = Category::whereDoesntHave('products')->get();
foreach ($emptyCategories as $category) {
echo "空分类：{$category->name}" . PHP_EOL;
}
// whereDoesntHave 也支持闭包条件
// 查询没有价格大于100的商品的分类
$categoriesWithoutExpensiveProducts = Category::whereDoesntHave('products', function ($query) {
$query->where('price', '>', 100);
})->get();
总结来说，在Laravel Eloquent中同时过滤父子表数据，核心在于理解whereHas和with各自的职责：whereHas负责根据子表条件过滤主表记录，with的闭包负责控制子表数据的加载范围。两者配合使用才能实现父子表数据的同时过滤。在实际开发中，应根据具体的业务需求选择合适的组合方式，既要保证查询结果的准确性，也要关注查询性能的优化。如果只需要过滤主表而不需要加载子表数据，单独使用whereHas即可；如果需要查询不存在关联子表的主表记录，则使用whereDoesntHave方法。掌握这些方法的区别和适用场景，能够帮助开发者在面对复杂关联查询需求时写出高效且正确的代码。