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 取单条,语义相同。
原理流程
- 当前模型持有中间模型的本地键。
- 中间模型持有远端模型的外键。
- 关联查询 join 两层表,按链路条件过滤。
- 返回远端模型集合(或单条)。
代码或图示
// 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 查询。
原理流程
- 子记录持有
commentable_type与commentable_id。 - 访问关联时读取 type 字段确定模型类。
- 用 id 在该模型上查询父级。
- 回填到关联属性,后续访问不重复查询。
代码或图示
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,挂接多态远端关联。
原理流程
- 一对多:子表迁移增加
{name}_type、{name}_id。 - 父模型定义
morphMany(Comment::class, 'commentable')。 - 多对多:中间表增加 type、父键、远端键。
- 父模型定义
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 对象。
原理流程
- 关联方法链式调用
withPivot('expires_at', 'meta')。 - 查询中间表时 select 这些列。
- 远端模型的
pivot属性携带字段值。 - 访问
$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:幂等对齐,第二参数控制是否移除未列出记录。
原理流程
- attach:插入中间表行,写入 pivot 属性与时间戳。
- detach:按 ID 集合删除对应行。
- sync:对比现有行与目标集合,补插缺失、删除多余。
- 操作后可 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 挂载。
原理流程
- 编写继承
Illuminate\Database\Eloquent\Relations\Pivot的类。 - 声明
$table、两侧外键名与 incrementing 等属性。 - 关联方法调用
using(CustomPivot::class)。 - 查询时中间表行实例化为自定义 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 条)。
- 收集主模型 ID,批量查询 posts(1 条)。
- 收集 posts ID,批量查询 comments(1 条)。
- 内存回填关联属性,遍历不再触发查询。
代码或图示
$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,条件直接追加。
原理流程
with数组形式声明关联名与闭包。- 预加载该层时调用闭包加工查询。
- 按约束批量取关联记录。
- 回填到主模型关联属性。
代码或图示
$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 对多态关联按类型分别计数。
概念解释
计数不加载关联模型本体,只跑聚合子查询,适合列表展示“评论数/点赞数”而不展开关联数据。多态关联的父类型不同,需按类型分别统计。
原理流程
- 主查询构造时登记需要计数的关联。
- 框架为每个关联生成
select (select count(*) ...)子查询。 - 结果列映射到
{relation}_count属性。 - 访问属性读取计数值,不触发额外查询。
代码或图示
$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 生成存在性子查询过滤主模型;条件散落在闭包中容易与预加载条件不一致。抽取作用域方法后两处复用,避免筛选口径漂移。
原理流程
- 在关联方法或模型上定义公共约束作用域。
whereHas('comments', fn ($q) => $q->approved())复用。with('comments')预加载闭包同样调用该作用域。- 过滤与加载使用同一条件。
代码或图示
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 支持自定义聚合条件(最大/最小/排序)。
原理流程
- 关联方法先定义一对多关系。
- 链式调用
latestOfMany('created_at')限定取单条。 - 查询按排序条件取首条记录。
- 关联属性绑定单条模型实例。
代码或图示
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 模型的保存方法(具体方法名以版本源码为准)。
原理流程
- 关联定义
withPivot(...)与withTimestamps()。 - attach/sync 时写入 pivot 列与时间戳。
- 读取
$model->pivot->字段。 - 修改后通过 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 接收关联名与父模型类型数组。
原理流程
- 主模型持有多态关联(如 activities → target)。
- 调用
morphWithCount('target', [Post::class, Video::class])。 - 框架按类型分别生成匹配 type 与 id 的计数子查询。
- 结果属性按类型或统一列名返回计数。
代码或图示
$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() 是关系查询对象。
原理流程
- 调用关系方法取得关联对象。
- 链式追加条件(where/orderBy/select)。
- 执行 get/first/count 等终结方法。
- 返回符合约束的关联结果。
代码或图示
$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 可在代码中显式判断加载状态。
原理流程
with预加载后,各模型实例写入关联属性。- 遍历访问
$model->relation先查属性缓存。 - 已存在则返回内存结果;未存在触发查询。
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 的外键方向不要混淆。
概念解释
关联定义在当前模型上:第一外键连接当前模型与中间表,第二外键连接中间表与远端模型。缺省时按模型名约定推导表名与键名。
原理流程
- 声明远端模型类。
- 指定中间表名(可选,缺省按约定)。
- 指定当前侧外键与远端侧外键。
- 查询 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 层处理业务清理(发通知、删文件、清缓存)。软删除模型不物理删除,外键级联不触发,需事件层处理。
原理流程
- 迁移定义外键
onDelete('cascade')或 restrict。 - 父记录删除时数据库按约束处理子行。
- 模型 deleting 钩子执行应用层清理。
- 多态/软删除场景核对子记录是否被正确处理。
代码或图示
// 迁移外键
$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 基类定义关联协议:约束查询、匹配父级、预加载匹配、反转关联等方法。自定义关系需实现这些方法,工作量较大,应先评估原生关联+作用域是否可覆盖。
原理流程
- 评估内置关联是否缺失能力。
- 继承 Relation,定义构造参数与表链路。
- 实现约束、匹配、预加载等基类抽象方法。
- 模型中方法返回自定义关系实例。
代码或图示
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 列越窄内存越省;回填组装依赖当前模型键与关联外键,缺列会导致关联挂不上。排序作用于关联集合内部顺序。
原理流程
with闭包内调用 select 指定列。- 保留主键、外键与业务展示列。
- orderBy 指定关联排序字段与方向。
- 批量查询后按内存组装关联。
代码或图示
$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)是更推荐的显式输出层,模型字段隐藏作为兜底。
原理流程
- 模型定义 hidden/visible/appends。
- 序列化时过滤属性,追加访问器值。
- 已加载关联按可见规则输出;未加载关联不出现。
- 资源类逐字段组装响应结构。
代码或图示
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调整可见属性;具体方法名以版本源码为准。