罗罗编程学习记录
本页内容 展开查看

06.5.4.6 Eloquent 高级关系与预加载

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.4 Laravel

覆盖范围

  • hasManyThrough、多态关联与多对多中间表操作
  • 嵌套预加载、约束闭包与关联计数
  • 关系复用、自定义中间表模型与序列化控制

基础关联类型见 06.5.1.3 Eloquent ORM 与事务;本页聚焦高级关系机制。

06.5.4.6-001 hasManyThrough(及 hasOneThrough)的外键链路如何定义?

一句话结论

hasManyThrough 穿过中间模型建立远端关联:当前模型 → 中间模型外键 → 远端模型外键,参数依次为远端模型、中间模型及各层外键/本地键,适合“国家 → 城市 → 居民”这类跨两层查询。

概念解释

链路为 CurrentModel 通过中间表关联远端表。外键参数缺省时按命名约定推导:中间表存当前模型键,远端表存中间模型键。hasOneThrough 取单条,语义相同。

原理流程

  1. 当前模型持有中间模型的本地键。
  2. 中间模型持有远端模型的外键。
  3. 关联查询 join 两层表,按链路条件过滤。
  4. 返回远端模型集合(或单条)。

代码或图示

// Country 有很多 City,City 有很多 Resident
public function residents()
{
    return $this->hasManyThrough(
        Resident::class,
        City::class,
        'country_id',   // 中间表 cities 指向当前表的外键
        'city_id',      // 远端表 residents 指向中间表的外键
        'id',           // 当前表本地键
        'id'            // 中间表本地键
    );
}

常见误区

  • 外键参数顺序记错:链路方向反了会导致 join 条件错误,查询为空或串数据。
  • 把 through 关联当普通一对多加中间表条件:through 关联已封装两层 join,额外约束应在关联查询构造器上追加。

追问

  • through 关联支持预加载吗?答:支持,with('residents') 按关联定义生成跨层查询;预加载约束闭包同样可用。
  • 中间模型软删除会影响 through 查询吗?答:中间模型全局作用域会进入 join 条件;需要包含已删除中间记录需在关联查询中显式处理。

06.5.4.6-002 morphTo 多态反向关联如何识别类型与 ID?

一句话结论

morphTo 读取记录中的多态类型字段(记录“属于哪个模型类”)与多态 ID 字段(记录“该类哪条记录”),动态查询对应模型并回填父级实例。

概念解释

多态关联用两个字段表达反向归属:{name}_type 存模型类名(或别名),{name}_id 存主键。morphTo 根据 type 字段解析模型类,再按 id 查询。

原理流程

  1. 子记录持有 commentable_type 与 commentable_id。
  2. 访问关联时读取 type 字段确定模型类。
  3. 用 id 在该模型上查询父级。
  4. 回填到关联属性,后续访问不重复查询。

代码或图示

class Comment extends Model
{
    public function commentable()
    {
        return $this->morphTo();
    }
}

// 表字段:commentable_type, commentable_id

常见误区

  • type 字段存短名/别名与模型类映射不一致:解析不到模型类,关联为空。
  • 多态 ID 字段与外键混用:同一列不能同时服务不同关联方向,需按关联拆分字段。

追问

  • 多态类型别名如何配置?答:在模型或关系注册中映射别名到类名;具体注册 API 以当前版本源码为准。
  • morphTo 支持预加载约束吗?答:不同父类模型字段不同,跨类型约束能力有限;按类型区分的条件建议在查询后集合层处理。

06.5.4.6-003 morphMany / morphToMany 多态一对多与多对多如何建表?

一句话结论

morphMany 在子表放 type + id 两列指向父级;morphToMany 在中间表放类型、父级键、远端键三列,使同一远端模型可关联多种父模型。

概念解释

一对多多态:父模型 morphMany(子模型, 名称),子表多态字段随子记录保存。多对多多态:中间表同时记录父类型、父 ID、远端 ID,挂接多态远端关联。

原理流程

  1. 一对多:子表迁移增加 {name}_type、{name}_id。
  2. 父模型定义 morphMany(Comment::class, 'commentable')。
  3. 多对多:中间表增加 type、父键、远端键。
  4. 父模型定义 morphToMany(Tag::class, 'taggable')。

代码或图示

// 一对多
public function comments()
{
    return $this->morphMany(Comment::class, 'commentable');
}

// 多对多
public function tags()
{
    return $this->morphToMany(Tag::class, 'taggable');
}

常见误区

  • 多态字段长度/索引不足:type 存类名较长,索引需覆盖 type+id 组合。
  • 多对多中间表漏 type 列:不同父类型记录混在同一远端关联下,归属错乱。

追问

  • 多态多对多的 pivot 字段如何取?答:与 belongsToMany 一样用 withPivot 声明;中间表时间戳由 pivot 配置控制。
  • 删除父记录时多态子记录如何清理?答:通过模型事件或外键策略处理;多态关联不默认级联删除,需在迁移/事件中显式定义。

06.5.4.6-004 belongsToMany 中间表字段如何用 withPivot 取出?

一句话结论

withPivot(字段名...) 声明中间表额外字段,取出的远端模型通过 $model->pivot 属性访问这些列;未声明的 pivot 字段不会被 select 带出。

概念解释

中间表除两侧外键外可存附加数据(角色授予时间、自定义排序、备注)。关联定义时声明字段,预加载与单条查询都会把它们挂到 pivot 对象。

原理流程

  1. 关联方法链式调用 withPivot('expires_at', 'meta')。
  2. 查询中间表时 select 这些列。
  3. 远端模型的 pivot 属性携带字段值。
  4. 访问 $user->pivot->expires_at 读取。

代码或图示

public function roles()
{
    return $this->belongsToMany(Role::class)
        ->withPivot('granted_at', 'expires_at')
        ->withTimestamps();
}

// 读取
$role->pivot->granted_at;

常见误区

  • 未 withPivot 就读取附加列:pivot 对象上无该属性,取值为 null 或报错。
  • pivot 字段在迁移中存在但关联未声明:数据已存,代码层取不到。

追问

  • pivot 模型如何自定义类?答:用 using(PivotModel::class) 指定中间表模型,见后续题。
  • 多态多对多也支持 withPivot 吗?答:支持,机制与 belongsToMany 一致。

06.5.4.6-005 attach / detach / sync 操作中间表的差异与陷阱?

一句话结论

attach 追加关联记录(可带 pivot 属性),detach 移除指定记录,sync 以给定集合为准全量对齐中间表(多余的移除、缺少的补上);三者都可附带 pivot 数据与触摸时间戳。

概念解释

  • attach:增量插入,重复附加取决于中间表唯一约束。
  • detach:按 ID 或集合删除中间表行,不传参删除全部关联。
  • sync:幂等对齐,第二参数控制是否移除未列出记录。

原理流程

  1. attach:插入中间表行,写入 pivot 属性与时间戳。
  2. detach:按 ID 集合删除对应行。
  3. sync:对比现有行与目标集合,补插缺失、删除多余。
  4. 操作后可 touch 远端模型时间戳。

代码或图示

$user->roles()->attach($roleId, ['granted_at' => now()]);
$user->roles()->detach([$roleId]);
$user->roles()->sync([1, 2, ['expires_at' => now()->addMonth()]]);

常见误区

  • 用 sync 做增量授权:未列出的既有关联被移除,误删角色。
  • attach 重复插入无唯一约束的中间表:产生重复行,查询关联数量偏大。

追问

  • sync 第二参数 $detaching 作用?答:传 false 时只补插缺失记录,不移除既有记录;具体签名以版本源码为准。
  • 操作 pivot 时间戳如何维护?答:关联 withTimestamps() 后 attach/sync 自动写中间表 created/updated 列。

06.5.4.6-006 自定义中间表模型 using() 如何挂载到多对多?

一句话结论

using(PivotModel::class) 指定继承 Pivot 的中间表模型类,把中间表行封装为对象,可在其上定义访问器、方法与事件;默认 pivot 是泛型 Pivot 实例。

概念解释

当中间表附加逻辑复杂(派生字段、校验、业务方法),默认 pivot 对象不够用。自定义 pivot 模型声明关联两侧外键与表名,关联通过 using 挂载。

原理流程

  1. 编写继承 Illuminate\Database\Eloquent\Relations\Pivot 的类。
  2. 声明 $table、两侧外键名与 incrementing 等属性。
  3. 关联方法调用 using(CustomPivot::class)。
  4. 查询时中间表行实例化为自定义 pivot 对象。

代码或图示

class MemberRole extends Pivot
{
    public $table = 'member_role';
    public bool $incrementing = false;

    public function isActive(): bool
    {
        return $this->expires_at === null || $this->expires_at->isFuture();
    }
}

public function roles()
{
    return $this->belongsToMany(Role::class)->using(MemberRole::class);
}

常见误区

  • pivot 模型忘记关闭自增:中间表无主键自增列,incrementing 需置 false。
  • 自定义 pivot 与 withPivot 字段冲突:字段声明应与 pivot 模型属性/列一致。

追问

  • pivot 模型支持事件吗?答:Pivot 基类提供模型事件能力;具体事件钩子与持久化行为以源码为准。
  • 多态多对多能 using 自定义 pivot 吗?答:可以,机制与普通多对多相同。

06.5.4.6-007 嵌套预加载 with('posts.comments') 的查询次数如何计算?

一句话结论

每层关联一次查询:主模型一次,posts 一次,comments 一次;嵌套层级每深一层增加一条预加载查询,而不是按主记录数展开 N+1。

概念解释

预加载按“关联层”批量取数:先查主模型,再用主模型 ID 集合查 posts,再用 posts ID 集合查 comments,最后在内存中组装。嵌套层级数 + 1 条 SQL。

原理流程

  1. 查询主模型集合(1 条)。
  2. 收集主模型 ID,批量查询 posts(1 条)。
  3. 收集 posts ID,批量查询 comments(1 条)。
  4. 内存回填关联属性,遍历不再触发查询。

代码或图示

$users = User::with('posts.comments')->get();

// SQL 概览:
// 1. select * from users
// 2. select * from posts where user_id in (...)
// 3. select * from comments where post_id in (...)

常见误区

  • 以为嵌套预加载会按用户数翻倍查询:批量按 ID 集合取数,与主记录条数无关。
  • 嵌套深层关联未写全:遍历到缺失层级时触发延迟加载,回到 N+1。

追问

  • 嵌套关联可以叠加约束闭包吗?答:可以,with(['posts' => fn ($q) => $q->where('active', true)]),闭包作用于该层查询。
  • 预加载关联数量很大时内存如何控制?答:分层使用 lazy/chunk,避免一次性把深层集合全部载入内存,见 06.5.4.7 Eloquent 查询优化与 N+1 治理。

06.5.4.6-008 预加载约束闭包如何限定关联查询条件?

一句话结论

with(['relation' => fn ($query) => ...]) 闭包接收关联查询构造器,可追加 where、排序、select 列等约束;只过滤关联记录,不影响主模型查询。

概念解释

约束闭包在批量取关联时生效,常用于只取有效评论、按时间排序关联、限制 select 列。闭包内返回查询构造器或 void,条件直接追加。

原理流程

  1. with 数组形式声明关联名与闭包。
  2. 预加载该层时调用闭包加工查询。
  3. 按约束批量取关联记录。
  4. 回填到主模型关联属性。

代码或图示

$posts = Post::with([
    'comments' => fn ($q) => $q->where('approved', true)->latest(),
    'author' => fn ($q) => $q->select('id', 'name'),
])->get();

常见误区

  • 闭包条件误加在主模型上:约束只作用于关联查询,主模型过滤需在外层查询构造器写。
  • select 列漏掉关联外键:回填组装需要两侧键,缺列导致关联挂不上。

追问

  • 约束闭包能加关联计数吗?答:可在闭包内 withCount 子关联;嵌套计数写法以版本支持为准。
  • 闭包内调用模型本地作用域可以吗?答:可以,查询构造器支持模型作用域方法链式调用。

06.5.4.6-009 withCount / withExists / morphWithCount 统计关联数量?

一句话结论

withCount 在主查询上追加子查询统计关联行数并生成 {relation}_count 属性;withExists 生成布尔存在标记;morphWithCount 对多态关联按类型分别计数。

概念解释

计数不加载关联模型本体,只跑聚合子查询,适合列表展示“评论数/点赞数”而不展开关联数据。多态关联的父类型不同,需按类型分别统计。

原理流程

  1. 主查询构造时登记需要计数的关联。
  2. 框架为每个关联生成 select (select count(*) ...) 子查询。
  3. 结果列映射到 {relation}_count 属性。
  4. 访问属性读取计数值,不触发额外查询。

代码或图示

$posts = Post::withCount('comments')->withExists('likedBy')->get();

// 多态计数
$activities = Activity::morphWithCount('target', ['Post', 'Video'])->get();

常见误区

  • 用 withCount 后又 with 加载同一关联:计数子查询与预加载查询并存,按需选择。
  • 计数关联带软删除:子查询是否带全局作用域需核对,必要时在关联定义中明确。

追问

  • 计数别名如何自定义?答:withCount(['comments as comments_total']) 形式可指定结果列名;具体语法以版本源码为准。
  • morphWithCount 与普通 withCount 区别?答:多态父表类型混杂,普通子查询无法跨表计数,需按类型拆分子查询。

06.5.4.6-010 whereHas 与关系方法条件如何复用同一约束?

一句话结论

把公共查询条件写成模型本地作用域或关联方法内的约束,whereHas 闭包与预加载闭包都调用同一作用域,保证“过滤主模型”与“加载关联”口径一致。

概念解释

whereHas 生成存在性子查询过滤主模型;条件散落在闭包中容易与预加载条件不一致。抽取作用域方法后两处复用,避免筛选口径漂移。

原理流程

  1. 在关联方法或模型上定义公共约束作用域。
  2. whereHas('comments', fn ($q) => $q->approved()) 复用。
  3. with('comments') 预加载闭包同样调用该作用域。
  4. 过滤与加载使用同一条件。

代码或图示

public function scopeApproved($query)
{
    return $query->where('approved', true);
}

$posts = Post::whereHas('comments', fn ($q) => $q->approved())
    ->with(['comments' => fn ($q) => $q->approved()])
    ->get();

常见误区

  • whereHas 条件与 with 条件各写一套:筛选出的主模型其关联未按同口径加载,数据不一致。
  • 在 whereHas 闭包中加载关联:存在子查询内不能嵌套预加载,预加载需在外层 with 声明。

追问

  • whereHas 与 has 区别?答:has 只判断关联存在(可带数量比较),whereHas 支持闭包细粒度条件;whereDoesntHave 取无关联记录。
  • 复用约束对 through 关联生效吗?答:作用域方法定义在远端模型上即可复用,through 关联查询同样可调用。

06.5.4.6-011 关系默认值(ofMany / latestOfMany)如何取关联单条?

一句话结论

hasOne 风格关联可用 latestOfMany / oldestOfMany / ofMany 从一对多中取一条代表记录(如最新订单、最高分评论),返回单条关联而非集合。

概念解释

一对多默认返回集合;业务常需“取最新一条”。latestOfMany 按指定列排序取首条,ofMany 支持自定义聚合条件(最大/最小/排序)。

原理流程

  1. 关联方法先定义一对多关系。
  2. 链式调用 latestOfMany('created_at') 限定取单条。
  3. 查询按排序条件取首条记录。
  4. 关联属性绑定单条模型实例。

代码或图示

public function latestOrder()
{
    return $this->hasOne(Order::class)->latestOfMany('created_at');
}

public function topComment()
{
    return $this->hasOne(Comment::class)->ofMany('likes', 'max');
}

常见误区

  • 把 ofMany 用在 belongsToMany:代表记录取一条适用于一对多/一对一链路,多对多语义不同。
  • 排序字段无索引:取首条子查询排序成本高,需配合索引。

追问

  • 该关联支持预加载吗?答:支持,with('latestOrder') 按关联定义批量取代表记录。
  • 多条并列时取哪条?答:按排序字段确定顺序,并列结果需补充次级排序键保证稳定。

06.5.4.6-012 pivot 模型的时间戳与自定义属性如何维护?

一句话结论

withTimestamps() 让中间表维护 created_at/updated_at;自定义属性通过 withPivot 声明并在 attach/sync 时写入,pivot 对象读取后可修改并调用 pivot 保存方法持久化。

概念解释

中间表时间戳由关联配置控制;附加业务列需显式声明。更新已有中间行的自定义值,先改 pivot 属性,再调用 pivot 模型的保存方法(具体方法名以版本源码为准)。

原理流程

  1. 关联定义 withPivot(...) 与 withTimestamps()。
  2. attach/sync 时写入 pivot 列与时间戳。
  3. 读取 $model->pivot->字段。
  4. 修改后通过 pivot 实例持久化变更。

代码或图示

public function members()
{
    return $this->belongsToMany(Member::class)
        ->withPivot('role', 'meta')
        ->withTimestamps();
}

// 更新中间表属性
$pivot = $member->pivot;
$pivot->role = 'editor';
$pivot->save();

常见误区

  • 直接改远端模型属性当成改 pivot:pivot 是独立对象,需通过 ->pivot 访问。
  • 未声明 withTimestamps 就读写时间列:列不在 select 范围,取值缺失。

追问

  • pivot 时间戳使用哪个时区?答:遵循模型日期序列化与应用时区配置;日期列类型转换由 pivot 模型处理。
  • 批量更新中间表属性怎么做?答:sync 传数组携带新值,或查询中间表模型批量更新;注意绕过关联时的作用域条件。

06.5.4.6-013 多态关联计数 morphWithCount 与普通 withCount 区别是什么?

一句话结论

普通 withCount 针对确定表生成聚合子查询;多态关联的父级分散在多张表,morphWithCount 按给定父模型类型分别生成子查询并合并计数,避免跨表无法单表 count 的问题。

概念解释

多态反向关联的 type 列决定记录归属表。统一一条 count 子查询无法跨多张父表统计,需按类型拆分。morphWithCount 接收关联名与父模型类型数组。

原理流程

  1. 主模型持有多态关联(如 activities → target)。
  2. 调用 morphWithCount('target', [Post::class, Video::class])。
  3. 框架按类型分别生成匹配 type 与 id 的计数子查询。
  4. 结果属性按类型或统一列名返回计数。

代码或图示

$activities = Activity::morphWithCount('target', [
    Post::class,
    Video::class,
])->get();

常见误区

  • 漏传父模型类型数组:未列出的类型记录不计入统计。
  • 多态 type 存别名而非类名:子查询匹配值需与 type 实际存储格式一致。

追问

  • 多态关联能 with 预加载本体吗?答:可以 with('target'),按 type 分别查询父表;混合类型字段展示需在集合层分支处理。
  • 计数列命名规则?答:通常为 {relation}_count,按类型拆分时的列名以版本实现为准。

06.5.4.6-014 关系方法返回的查询构造器如何继续追加约束?

一句话结论

访问关系属性得到模型/集合;通过关系方法(如 $user->posts())返回 BelongsTo/HasMany 等关联对象,其底层查询构造器可链式追加 where、排序、select 后再执行查询。

概念解释

属性访问触发加载并返回结果;方法调用返回关联实例,处于可继续构造查询状态。两者区别:$user->posts 是集合,$user->posts() 是关系查询对象。

原理流程

  1. 调用关系方法取得关联对象。
  2. 链式追加条件(where/orderBy/select)。
  3. 执行 get/first/count 等终结方法。
  4. 返回符合约束的关联结果。

代码或图示

$activePosts = $user->posts()
    ->where('status', 'published')
    ->orderBy('published_at', 'desc')
    ->get();

常见误区

  • 在已加载集合上再调 where:集合方法过滤内存数据,不生成 SQL。
  • 混淆属性与方法:$user->posts()->where(...) 才是查询约束;$user->posts->where(...) 是集合过滤。

追问

  • 关联对象如何获取底层查询构造器?答:关联提供 getQuery/基础查询访问入口;具体方法名以版本源码为准。
  • 追加条件影响后续属性加载吗?答:方法调用生成的是独立查询,不回写已加载的属性缓存。

06.5.4.6-015 预加载关联在集合上如何复用已加载结果?

一句话结论

模型关联属性一旦预加载或首次访问,结果缓存在模型实例上;后续访问同一关联不再查询,判断关联是否已加载用 relationLoaded 方法避免重复触发延迟加载。

概念解释

Eloquent 按实例缓存关联属性。遍历集合时,已预加载的关联直接读内存;未加载的关联在访问时触发查询。relationLoaded 可在代码中显式判断加载状态。

原理流程

  1. with 预加载后,各模型实例写入关联属性。
  2. 遍历访问 $model->relation 先查属性缓存。
  3. 已存在则返回内存结果;未存在触发查询。
  4. relationLoaded('relation') 判断缓存是否存在。

代码或图示

if (! $user->relationLoaded('posts')) {
    $user->load('posts');
}
foreach ($user->posts as $post) {
    // 复用已加载集合
}

常见误区

  • 循环内反复 load 同一关联:已加载结果被重复查询覆盖,浪费 SQL。
  • 序列化输出未加载关联:默认只输出已加载与可见属性,避免误以为缺失字段是 bug。

追问

  • 如何强制重新加载关联?答:调用 load 或 fresh 刷新模型及其关联;属性缓存会被新查询替换。
  • 集合 map/filter 会触发关联查询吗?答:只操作内存集合;回调内访问未加载关联才触发查询。

06.5.4.6-016 多对多反向关联 belongsToMany 的外键对应关系?

一句话结论

belongsToMany(远端模型, 中间表, 当前模型在中间表的外键, 远端模型在中间表的外键);参数顺序先当前侧后远端侧,与 hasMany 的外键方向不要混淆。

概念解释

关联定义在当前模型上:第一外键连接当前模型与中间表,第二外键连接中间表与远端模型。缺省时按模型名约定推导表名与键名。

原理流程

  1. 声明远端模型类。
  2. 指定中间表名(可选,缺省按约定)。
  3. 指定当前侧外键与远端侧外键。
  4. 查询 join 中间表并按两侧键匹配。

代码或图示

public function roles()
{
    return $this->belongsToMany(
        Role::class,
        'member_role',
        'member_id',   // 当前模型在中间表的外键
        'role_id'      // 远端模型在中间表的外键
    );
}

常见误区

  • 两侧外键写反:中间表匹配条件颠倒,关联结果错乱。
  • 中间表名与约定不符又不显式传:框架按模型名拼接表名导致找不到表。

追问

  • 自定义本地键/远端键参数在哪?答:belongsToMany 后两个参数分别对应当前表本地键与远端表本地键;完整签名以源码为准。
  • 两侧模型互相关联时外键如何对应?答:A 的 belongsToMany 中 A 侧外键对应 B 侧外键,反向关联在 B 上定义时两侧键互换。

06.5.4.6-017 关联删除与级联(onDelete / deleting 事件)注意什么?

一句话结论

数据库外键 onDelete 在数据层级联删子记录;模型 deleting 事件/观察者在应用层清理关联;多态关联与软删除场景不会自动级联,需显式选择清理策略。

概念解释

两层级联各有边界:外键约束在数据库执行,模型事件在 PHP 层处理业务清理(发通知、删文件、清缓存)。软删除模型不物理删除,外键级联不触发,需事件层处理。

原理流程

  1. 迁移定义外键 onDelete('cascade') 或 restrict。
  2. 父记录删除时数据库按约束处理子行。
  3. 模型 deleting 钩子执行应用层清理。
  4. 多态/软删除场景核对子记录是否被正确处理。

代码或图示

// 迁移外键
$table->foreign('post_id')->references('id')->on('posts')->onDelete('cascade');

// 模型事件清理
protected static function booted(): void
{
    static::deleting(function (Post $post) {
        $post->comments()->delete();
    });
}

常见误区

  • 只靠应用层事件删子记录:批量删除/直接 SQL 绕过模型事件,子记录残留。
  • 软删除后外键级联失效:子表关联的是已软删父行,需业务层处理归属与展示。

追问

  • restrict 与 cascade 怎么选?答:仍需引用父记录用 restrict 阻止删除;父销毁子无意义用 cascade,结合业务恢复需求决定。
  • 关联 detach 与 delete 区别?答:detach 只删中间表行,远端模型保留;delete 删除远端模型本体。

06.5.4.6-018 自定义关系类(extend Relation)在什么场景使用?

一句话结论

内置关联类型无法表达特殊链路(跨库、复合键、非标准中间表、聚合关联)时,继承 Relation 基类实现查询匹配与关联回填逻辑;常规 CRUD 不需要自定义关系类。

概念解释

Relation 基类定义关联协议:约束查询、匹配父级、预加载匹配、反转关联等方法。自定义关系需实现这些方法,工作量较大,应先评估原生关联+作用域是否可覆盖。

原理流程

  1. 评估内置关联是否缺失能力。
  2. 继承 Relation,定义构造参数与表链路。
  3. 实现约束、匹配、预加载等基类抽象方法。
  4. 模型中方法返回自定义关系实例。

代码或图示

class TeamsThroughMembers extends Relation
{
    // 实现基类要求的约束与匹配方法
    public function addConstraints() { /* ... */ }
    public function match(array $models, Collection $results, $relation) { /* ... */ }
}

常见误区

  • 普通多条件查询就自定义关系:关联查询构造器与本地作用域通常足够。
  • 自定义关系未实现预加载匹配:with 时关联挂不上,返回空。

追问

  • 自定义关系能被 whereHas/withCount 使用吗?答:取决于基类方法实现是否提供存在性与计数能力;完整适配需实现对应查询约束。
  • 框架内置关系源码从哪读?答:Illuminate\Database\Eloquent\Relations 目录,参考 HasMany/BelongsToMany 的实现结构。

06.5.4.6-019 预加载关联排序与 select 列限制?

一句话结论

关联查询可在约束闭包内 orderBy 排序、select 限制列;但必须保留两侧外键与回填所需字段,否则关联组装失败或排序失效。

概念解释

预加载批量取数时 select 列越窄内存越省;回填组装依赖当前模型键与关联外键,缺列会导致关联挂不上。排序作用于关联集合内部顺序。

原理流程

  1. with 闭包内调用 select 指定列。
  2. 保留主键、外键与业务展示列。
  3. orderBy 指定关联排序字段与方向。
  4. 批量查询后按内存组装关联。

代码或图示

$posts = Post::with([
    'comments' => fn ($q) => $q
        ->select('id', 'post_id', 'body', 'created_at')
        ->orderBy('created_at', 'desc'),
])->get();

常见误区

  • select 漏掉 post_id:comments 无法回填到对应 post。
  • 按未加载列排序:select 列不含排序字段时排序不可用,需把排序列加入 select。

追问

  • 主模型也能限制列吗?答:可以在主查询 select,同样需保留主键供关联回填。
  • 关联排序会影响主模型分页吗?答:不会,分页作用于主模型;关联集合顺序独立。

06.5.4.6-020 关联序列化时如何控制输出(hidden/append/with)?

一句话结论

模型序列化通过 $hidden 隐藏敏感字段、$visible 白名单、$appends 追加访问器属性;关联用 $with 默认预加载,或在资源/数组转换时显式 load 控制输出哪些关联。

概念解释

API 输出不应直接暴露模型全部属性。关联是否出现取决于是否加载、是否在可见范围;资源类(Resource)是更推荐的显式输出层,模型字段隐藏作为兜底。

原理流程

  1. 模型定义 hidden/visible/appends。
  2. 序列化时过滤属性,追加访问器值。
  3. 已加载关联按可见规则输出;未加载关联不出现。
  4. 资源类逐字段组装响应结构。

代码或图示

class User extends Model
{
    protected $hidden = ['password', 'remember_token'];
    protected $appends = ['full_name'];
    protected $with = ['roles'];
}

// 控制器显式控制
return User::with('profile')->get()->toArray();

常见误区

  • 在模型 $with 中加载重关联:每个序列化点都预加载,列表接口成本失控。
  • 直接返回模型集合:字段随模型定义漂移,前端契约不稳定;应走资源类。

追问

  • pivot 字段会被序列化输出吗?答:pivot 属性默认随模型输出;不需要时在模型隐藏或资源中过滤。
  • 如何临时隐藏某关联?答:序列化前 makeHidden/setHidden 调整可见属性;具体方法名以版本源码为准。