本文详细介绍了在 laravel 中如何使用 eloquent orm 同时筛选父表和子表数据。通过 `join` 语句实现 sql 级别的联合查询，以及利用 `wherehas` 方法进行 eloquent 关联约束查询，文章提供了两种解决方案，并对比了它们的适用场景、优缺点及注意事项，旨在帮助开发者高效地实现复杂的父子表数据过滤需求。
简介
在 Laravel 应用开发中，我们经常会遇到需要根据父表（主表）和其关联的子表（从表）中的字段来筛选数据的情况。例如，有一个 posts 表作为父表，以及一个 posts_tags 表作为子表，我们需要同时根据 posts 表中的 year 字段和 posts_tags 表中的 tag_id 字段来过滤帖子数据。本文将探讨两种主要的 Eloquent 方法来解决这一问题：使用 join 语句进行联合查询，以及使用 whereHas 方法进行关联约束查询。
准备工作：模型与关联
为了演示，我们假设已经定义了 Post 和 PostTag 两个 Eloquent 模型，并建立了它们之间的关联关系。
Post 模型 (app/Models/Posts/Post.php)
<?php
namespace App\Models\Posts;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Post extends Model
{
use HasFactory;
protected $table = "posts";
protected $guarded = [];
// 定义与 PostTag 的一对多关系
public function PostTags()
{
return $this->hasMany(PostTag::class);
}
}PostTag 模型 (app/Models/Posts/PostTag.php)
<?php
namespace App\Models\Posts;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class PostTag extends Model
{
use HasFactory;
protected $table = "posts_tags";
protected $guarded = [];
// 定义与 Post 的多对一反向关系
public function GetPost()
{
return $this->belongsTo(Post::class);
}
}在 MovieController 中，我们将处理来自前端的筛选请求，根据 year 和 tag 参数进行数据查询。
解决方案一：使用 join 语句进行联合查询
join 语句允许我们在 Eloquent 查询中执行 SQL 级别的表连接。这种方法直接在数据库层面将父表和子表连接起来，然后对连接后的结果进行筛选。
代码示例
<?php
namespace App\Http\Controllers\Movies;
use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use App\Models\Posts\Post;
use App\Models\Posts\PostTag; // 引入 PostTag 模型，尽管在此查询中不直接使用其 Eloquent 实例
class MovieController extends Controller
{
public function MoviesDataSearch(Request $request)
{
// 初始化查询构建器
$query = Post::query()
->where('posts.post_type', "movie")
->where('posts.is_delete', "0");
// 如果请求中存在年份，则添加年份筛选条件
if ($request->filled('year')) {
$query->where('posts.year', 'like', '%' . $request->year . '%');
}
// 如果请求中存在标签ID，则执行联合查询并添加标签筛选条件
if ($request->filled('tag')) {
// 使用 join 方法连接 posts 和 posts_tags 表
// 假设 posts_tags 表的外键是 post_id
$query->join('posts_tags', 'posts.id', '=', 'posts_tags.post_id')
->where('posts_tags.tag_id', $request->tag); // 对于 tag_id 通常使用精确匹配
}
// 确保返回的是 Post 模型实例，而非 stdClass 对象
// 并且避免因 join 带来的列名冲突，只选择 posts 表的所有列
$movies = $query->select('posts.*')
->orderBy('posts.id', 'DESC')
->paginate(12); // 根据需求调整分页大小
// 将请求参数附加到分页链接中
return $movies->appends($request->all());
}
}注意事项
- 列名限定： 当使用 join 语句时，如果父表和子表有同名字段，或者为了清晰起见，强烈建议使用表名来限定列名（例如 posts.id, posts_tags.tag_id），以避免歧义。
- 返回结果： 默认情况下，join 查询返回的是 stdClass 对象集合，而非 Eloquent 模型实例。如果需要返回 Post 模型实例，并能够继续使用其定义的关联关系，必须在查询中显式使用 select('posts.*') 来指定只选择父表的所有列。
- 外键正确性： join 条件中的外键 (posts_tags.post_id) 必须正确指向父表的主键 (posts.id)。
- 性能： 对于大型数据集，join 查询通常在数据库层面效率更高，因为它直接处理表的连接。
解决方案二：使用 whereHas 约束关联查询
whereHas 方法是 Eloquent 提供的一种更“面向对象”的方式来筛选父模型，它根据关联模型是否存在且满足特定条件来过滤父模型。
代码示例
<?php
namespace App\Http\Controllers\Movies;
use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use App\Models\Posts\Post;
class MovieController extends Controller
{
public function MoviesDataSearch(Request $request)
{
// 初始化查询构建器
$query = Post::query()
->where('post_type', "movie")
->where('is_delete', "0");
// 如果请求中存在年份，则添加年份筛选条件
if ($request->filled('year')) {
$query->where('year', 'like', '%' . $request->year . '%');
}
// 如果请求中存在标签ID，则使用 whereHas 添加关联筛选条件
if ($request->filled('tag')) {
// whereHas 检查是否存在至少一个关联的 PostTag 满足条件
$query->whereHas('PostTags', function ($subQuery) use ($request) {
$subQuery->where('tag_id', $request->tag); // 对于 tag_id 通常使用精确匹配
});
}
$movies = $query->orderBy('id', 'DESC')
->paginate(12); // 根据需求调整分页大小
// 将请求参数附加到分页链接中
return $movies->appends($request->all());
}
}注意事项
- 关联关系： whereHas 依赖于模型中正确定义的关联关系 (PostTags 方法)。
- 返回结果： whereHas 始终返回父模型的 Eloquent 实例，因此可以直接继续使用父模型的方法和关联。
- 子查询： whereHas 在底层通常会生成一个子查询或一个 INNER JOIN 来实现过滤。
- orWhereHas： 如果需要满足多个关联条件中的任意一个，可以使用 orWhereHas。
- with vs whereHas： with 用于预加载关联数据，而 whereHas 用于筛选父模型。它们可以结合使用，例如 Post::whereHas(...)->with('PostTags')->get()。
如何选择合适的查询方法
-
使用 join 的场景：
- 当你需要直接访问被连接表中的字段，并且这些字段不是通过关联关系方便获取的。
- 当你处理非常大的数据集，且 join 在数据库层面可能比子查询更高效时。
- 当你不需要返回 Eloquent 模型实例，或者愿意手动指定 select 语句来构建模型时。
-
使用 whereHas 的场景：
- 当你希望以更“Eloquent”的方式进行查询，保持代码的面向对象特性。
- 当你主要关心父模型，并且只需要根据关联模型的存在性或属性来过滤父模型时。
- 当你需要返回 Eloquent 模型实例，并希望能够继续使用其定义的关联关系和访问器时。
在大多数情况下，如果只是根据关联表中的某个字段来筛选父表数据，whereHas 是更推荐的 Eloquent 惯用法，因为它更简洁且保持了 Eloquent 模型的完整性。只有在特定的性能优化需求或复杂的多表连接场景下，才可能需要直接使用 join。
最佳实践与优化
- 动态条件添加： 在控制器中，使用 if ($request->filled('field')) { ... } 结构来动态添加查询条件，避免在没有参数时执行不必要的筛选。
- 安全性： 始终对用户输入进行验证和清理，防止 SQL 注入等安全问题。Laravel 的 Request 和 Eloquent 本身提供了很好的防护。
- 分页优化： paginate() 方法是处理大量数据的标准方式。appends($request->all()) 确保在分页链接中保留所有筛选参数，提升用户体验。
- 索引： 确保 posts.id、posts.year、posts_tags.post_id 和 posts_tags.tag_id 等用于筛选和连接的列都建立了数据库索引，以优化查询性能。
总结
在 Laravel 中同时筛选父表和子表数据，可以通过 join 语句实现直接的 SQL 联合查询，或者利用 whereHas 方法进行 Eloquent 关联约束查询。两种方法各有优势，join 更侧重于底层数据库操作的灵活性和性能，而 whereHas 则提供了更优雅、更符合 Eloquent 哲学的方式来处理关联数据筛选。开发者应根据具体需求、数据量以及对代码可读性和维护性的考量，选择最合适的查询策略。
