Laravel的Eloquent ORM提供了便捷的关系预加载能力,通过with方法可以一次性加载关联模型,避免N+1查询问题。在实际开发中,我们常常需要在预加载关联数据的同时,对关联查询添加筛选条件,这时候就可以在with方法中使用闭包函数来实现带约束的预加载。

基础用法:单关联带约束预加载
假设我们有两个模型:User(用户)和Post(文章),User和Post是一对多关系,User模型中定义了posts关联方法。现在需要查询所有用户,同时只加载他们状态为已发布的文章,就可以用如下方式实现:
<?php
// User模型中的关联定义
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
public function posts()
{
return $this->hasMany(Post::class);
}
}
// 带约束的预加载查询
$users = User::with(['posts' => function ($query) {
// 闭包内的$query是关联模型的查询构造器
$query->where('status', 'published')->orderBy('created_at', 'desc');
}])->get();
// 遍历结果时,每个用户的posts里只有已发布且按创建时间倒序的文章
foreach ($users as $user) {
echo $user->name . '的已发布文章:' . $user->posts->count() . '篇';
}多条件组合约束
闭包中支持添加多个查询条件,和普通查询构造器的用法一致,比如同时筛选发布时间和状态:
<?php
$users = User::with(['posts' => function ($query) {
$query->where('status', 'published')
->where('created_at', '>=', now()->subMonth())
->limit(5); // 每个用户最多加载5篇近一个月的已发布文章
}])->get();嵌套关联的带约束预加载
如果存在多层关联,比如User关联Post,Post又关联Comment(评论),需要预加载用户的同时,加载用户的文章以及文章下审核通过的评论,可以通过嵌套数组的方式实现:
<?php
$users = User::with(['posts' => function ($query) {
$query->where('status', 'published');
}, 'posts.comments' => function ($query) {
$query->where('is_approved', 1)->orderBy('created_at', 'asc');
}])->get();常见注意事项
- 闭包中的$query对应的是关联模型的查询构造器,不要和主模型的查询构造器混淆,主模型的筛选条件要写在with方法外面。
- 带约束的预加载不会影响主模型的查询结果,只会筛选关联模型的数据,比如上面的查询会返回所有用户,只是部分用户的posts集合可能为空。
- 如果需要对关联数据做分页,不建议在预加载闭包中使用paginate,因为预加载是给每个主模型加载关联,分页逻辑一般放在主查询或者单独查询关联时使用。
- 当关联是belongsToMany多对多关系时,闭包中也可以正常使用where、orderBy等条件,还可以筛选中间表的字段,比如:
<?php
// User和Role是多对多关系,中间表有expired_at字段
$users = User::with(['roles' => function ($query) {
$query->where('expired_at', '>', now())
->orWhereNull('expired_at');
}])->get();使用场景总结
带约束的预加载适合以下场景:需要关联数据但不需要全部关联数据、需要按特定规则排序关联数据、需要限制关联数据的数量。合理使用这一特性可以减少不必要的数据库查询,提升接口响应速度,同时让查询逻辑更清晰。