06.5.3.7 ActiveRecord 与关联关系
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.3 Yii
06.5.3.7-001 ActiveRecord 类如何映射数据库表?
一句话结论
AR 类继承 yii\db\ActiveRecord,通过 tableName() 返回表名,属性对应字段,getDb() 指定数据库连接;类即表映射对象,无需手写每行的字段声明。
概念解释
表名可带表前缀占位 {{%post}},前缀由连接配置展开。AR 属性按表字段动态读取,类内可声明常量、关联方法与业务方法。多张表可复用同一基类抽象公共行为。
原理流程
- 定义类继承 AR,实现
tableName()。 - 框架从数据库 Schema 读取字段元数据。
- 实例属性与表字段一一对应。
代码或图示
class Post extends yii\db\ActiveRecord
{
public static function tableName(): string
{
return '{{%post}}';
}
}
常见误区
- 表名硬编码前缀:换环境改前缀时全表名失效,应使用
{{%}}占位。 - 在 AR 类里声明与字段同名的公共属性覆盖动态映射:可能导致属性读写绕过字段同步。
追问
- 如何指定非默认数据库连接?答:覆盖
getDb()返回对应连接组件;默认取Yii::$app->db。 - 字段元数据何时加载?答:首次解析表结构时从 Schema 读取并缓存,生产环境配合 Schema 缓存降低开销。
06.5.3.7-002 AR 实例的生命周期是怎样的?
一句话结论
实例经历 new(未保存)→ validate → save(内部 insert 或 update)→ delete;isNewRecord 标识是否为数据库新记录,保存前后触发对应事件。
概念解释
save() 先校验(可跳过),通过后按 isNewRecord 走 insert 或 update;新增成功后填充自增主键。删除调用 delete() 执行 DELETE 语句,实例内存状态不自动清空。
原理流程
new Post():内存对象,isNewRecord=true。- 赋值属性,
validate()校验规则。 save():通过则 insert/update,触发生命周期事件。delete():按主键删除对应行。
代码或图示
$post = new Post();
$post->title = '示例';
if ($post->save()) {
echo $post->id; // 自增主键回填
}
常见误区
- 不检查
save()返回值:校验失败或写入失败被忽略,数据未落库。 - 删除后继续使用实例:内存对象仍持有旧属性,不代表数据库状态。
追问
- save 与 insert/update 关系?答:
save()按新记录判定分发;也可直接调用insert()/update(),但需自行处理校验与主键。 - 事务包裹多实例保存怎么做?答:在连接层开启事务,多个 save 在同一事务内提交或回滚。
06.5.3.7-003 rules() 与批量赋值安全有什么关系?
一句话结论
rules() 声明可批量赋值的安全属性与校验规则;通过 load() 或 attributes 赋值时,未列入当前场景安全属性的字段不会被外部输入覆盖,防止越权写入。
概念解释
批量赋值把请求参数映射到模型属性;只有安全属性(出现在规则对应场景中)接受赋值。attributes 数组直接赋值同样受安全属性约束。规则同时定义校验器与参数约束。
原理流程
rules()返回每组:字段、验证器、场景选项。load()按当前场景筛选安全字段。- 非安全字段保持原值,外部输入被忽略。
代码或图示
public function rules(): array
{
return [
[['title', 'body'], 'required'],
['title', 'string', 'max' => 255],
['status', 'in', 'range' => ['draft', 'published']],
];
}
常见误区
- 把
id、user_id、is_admin写进可批量赋值字段:外部参数可越权篡改归属与权限。 - 用
$model->attributes = $_POST替代 load:绕过场景与安全属性判断。
追问
- 规则中
on/except做什么?答:限定规则生效场景;未标 on 的规则对所有场景生效。 - 安全属性如何查询?答:模型提供
safeAttributes()一类方法返回当前场景可赋值字段,具体方法名以版本为准。
06.5.3.7-004 scenarios() 如何区分字段集与规则集?
一句话结论
scenarios() 按场景名声明字段分组,每个场景列出活动属性与对应规则;同一模型在创建、更新、后台等场景暴露不同可写字段与校验组合。
概念解释
场景是批量赋值与校验的上下文:create 场景允许设密码,update 场景不允许改密码;规则可通过 on 绑定场景。未覆盖 scenarios() 时框架按 rules 字段推导默认场景。
原理流程
- 设置
$model->scenario = 'register'。 scenarios()返回该场景属性列表。- load/validate 只处理场景内安全字段与规则。
代码或图示
public function scenarios(): array
{
return [
'register' => ['username', 'password', 'email'],
'profile' => ['nickname', 'avatar'],
];
}
常见误区
- 场景字段与 rules 字段脱节:场景允许但规则未覆盖,字段可赋值却不校验。
- 后台场景复用前台场景:敏感字段被前台输入覆盖,应拆分独立场景。
追问
- 场景如何在入口指定?答:动作中根据来源设置
$model->scenario,再 load 输入。 - 一个规则能否适用多场景?答:规则
on列多个场景名;不写 on 表示全部场景生效。
06.5.3.7-005 find()/findOne()/findAll() 查询入口如何使用?
一句话结论
find() 返回 ActiveQuery 用于链式构造;findOne($condition) 取单条记录,findAll($condition) 取多条;条件可为主键数组、哈希条件或 Query 对象。
概念解释
findOne 命中返回 AR 实例,未命中返回 null;findAll 返回实例数组(可能为空)。条件格式与 Query where 一致:主键、['field' => value]、操作符格式。
原理流程
find()构造查询对象。- 链式追加条件、排序、预加载。
one()/all()执行 SQL 并实例化 AR。
代码或图示
$post = Post::findOne(123);
$active = Post::findAll(['status' => 'published']);
$latest = Post::find()->where(['>', 'created_at', $since])->orderBy(['id' => SORT_DESC])->one();
常见误区
findOne传数组条件却期望多条:它只返回第一条匹配记录。- 未命中判空用
empty($model):应严格=== null,避免模型属性为空造成误判。
追问
- 条件非法会怎样?答:构造/执行阶段抛数据库异常;主键类型与字段不匹配时查不到记录而非自动转换。
- findAll 接受主键列表吗?答:接受主键值数组,按主键
IN查询。
06.5.3.7-006 ActiveQuery 与 AR 查询链是什么关系?
一句话结论
ActiveQuery 继承 Query,在通用查询能力之上补充 AR 实例化、关联预加载与关联条件;AR::find() 返回的就是 ActiveQuery,链式方法最终生成 Command 执行。
概念解释
Query 负责 SQL 构造(where/join/orderBy/limit),ActiveQuery 负责把结果行包装成 AR 实例、解析 with 关联。查询不立即执行,直到 one()/all()/count() 等取值方法调用。
原理流程
find()创建 ActiveQuery。- 链式方法追加查询条件与预加载声明。
- 取值时生成 Command,执行后实例化 AR 集合。
代码或图示
$query = Post::find()
->with('comments')
->where(['status' => 'published'])
->limit(10)
->orderBy(['created_at' => SORT_DESC]);
$posts = $query->all();
常见误区
- 链式调用后忘记取值:Query 对象不执行 SQL,传到处才被执行。
- 在 Query 上改模型属性:查询对象只描述 SQL,不能修改记录。
追问
- ActiveQuery 能否返回数组?答:
asArray()后结果为数组行,不实例化 AR,适合大批量只读场景。 - 查询对象能否复用?答:可作为构造模板复用,但链式调用会修改同一对象,复用时注意克隆或重新 find。
06.5.3.7-007 hasOne 关联如何定义?
一句话结论
hasOne(关联模型类, 关联键数组) 定义一对一/多对一关联,返回 ActiveQuery;关联方法以 getXxx() 命名,访问 $model->xxx 时懒加载执行。
概念解释
键数组格式 ['当前表外键' => '关联表主键'];属于当前模型持有外键的方向,例如文章属于作者。关联查询条件可在返回的 Query 上进一步追加。
原理流程
- 模型内写
getAuthor()调用hasOne。 - 访问
$post->author触发关联查询。 - 命中返回单条关联 AR,未命中返回 null。
代码或图示
public function getAuthor()
{
return $this->hasOne(User::class, ['id' => 'author_id']);
}
常见误区
- 键数组方向写反:本地键与关联键错位,关联查不到数据。
- 关联方法名与属性名混淆:访问属性走魔术 getter,调用方法得到 Query 对象。
追问
- hasOne 结果为 null 的语义?答:外键为空或关联行不存在时返回 null,代码访问前需判空。
- 关联能否带默认条件?答:在 hasOne 返回的 Query 上
andOnCondition/where 追加,具体方法以版本为准。
06.5.3.7-008 hasMany 关联如何定义?
一句话结论
hasMany(关联模型类, 关联键数组) 定义一对多关联,返回多条记录的 ActiveQuery;访问属性返回关联模型数组,无记录时为空数组。
概念解释
典型方向:作者有多篇文章,外键在关联表上。hasMany 结果总是数组集合,配合 with() 预加载;关联排序、过滤在 Query 上声明。
原理流程
- 模型内
getPosts()调hasMany。 - 访问
$author->posts触发IN查询。 - 返回按外键分组后的模型数组。
代码或图示
public function getPosts()
{
return $this->hasMany(Post::class, ['author_id' => 'id'])
->orderBy(['created_at' => SORT_DESC]);
}
常见误区
- 把 hasMany 结果当单条对象访问:集合需遍历或取首项。
- 关联排序写在主查询上:排序应声明在关联 Query 内。
追问
- 关联集合如何计数?答:访问
count或对关联 Query 单独count();预加载场景避免逐条计数触发额外查询。 - hasMany 能否限定状态?答:在返回 Query 上追加 where 条件,仅取符合条件的关联记录。
06.5.3.7-009 via() 与 viaTable() 中间表关联如何区分?
一句话结论
via() 通过已有关联经中间模型跳转,viaTable() 直接声明中间表与两表外键;多对多关联经中间表连接,两种方式按是否已有中间模型关联选择。
概念解释
via 第一参数是当前模型已定义的关联名,中间表先经该关联取出,再连目标表;viaTable 直接给中间表名与键映射,不要求中间表对应 AR 类。
原理流程
- 定义两侧直接关联。
- 多对多关联用 via 串起已有关联,或 viaTable 声明中间表。
- 预加载时按中间表 JOIN/IN 查询组装。
代码或图示
public function getTags()
{
return $this->hasMany(Tag::class, ['id' => 'tag_id'])
->viaTable('{{%post_tag}}', ['post_id' => 'id']);
}
常见误区
- via 与 viaTable 参数混用:via 取关联名,viaTable 取表名,方向错误导致 JOIN 错位。
- 中间表额外字段无处挂载:viaTable 只表达连接,附加属性需经中间模型关联处理。
追问
- 中间表模型需要定义 AR 吗?答:用 viaTable 可不定义;需要读取中间表额外字段时定义中间 AR 并用 via。
- 多对多删除关联怎么做?答:通过
unlink()清理中间表记录,具体行为按关联配置处理。
06.5.3.7-010 关联键与关联条件如何配置?
一句话结论
关联键数组声明本地键与关联键对应;附加条件用 onCondition 一类方法写在 JOIN/ON 条件中,区别于主查询 where 的过滤时机。
概念解释
键决定两表如何匹配;ON 条件在连接时生效,主 where 在结果过滤时生效。预加载关联时,关联条件随关联 Query 执行;跨表筛选要注意条件作用阶段。
原理流程
- hasOne/hasMany 传入键映射。
- 调用条件方法追加 ON 片段。
- JOIN/IN 查询按键与条件匹配。
代码或图示
public function getEnabledComments()
{
return $this->hasMany(Comment::class, ['post_id' => 'id'])
->onCondition(['comment.status' => 'approved']);
}
常见误区
- 用 where 写关联条件:预加载时可能过滤掉主记录,与 ON 条件语义不同。
- 键字段名与实际列不一致:SQL 报列错误或关联为空。
追问
- 关联条件能引用主表字段吗?答:ON 条件可表达跨表比较;复杂条件需结合 JOIN 方式验证生成 SQL。
- 关联默认条件如何复用?答:在关联方法内统一声明,所有引用该关联的查询继承条件。
06.5.3.7-011 什么是关联懒加载,什么时候触发额外查询?
一句话结论
首次访问未预加载的关联属性时,AR 按当前模型键执行一次关联查询;循环遍历多条记录逐个取关联时,每条都触发一次查询,形成 N+1 问题。
概念解释
懒加载按需取数,单条详情页访问关联通常可接受;列表场景逐条访问 $post->comments 会产生 1 次主查询 + N 次关联查询。关联结果在实例生命周期内缓存,同一实例重复访问不重复查。
原理流程
- 主查询取出 N 条 AR。
- 循环中首次访问某条的关联属性。
- 按该条外键执行关联查询,结果挂到实例。
代码或图示
foreach (Post::find()->all() as $post) {
echo count($post->comments); // 每条触发一次 comments 查询
}
常见误区
- 列表页依赖懒加载:数据量增大后 SQL 数线性增长。
- 以为关联属性在 find 时已取出:未 with 时关联数据不在主查询结果中。
追问
- 关联缓存何时失效?答:同一实例内复用;重新查询得到的是新实例,关联需再次加载。
- 懒加载能否关闭?答:访问即加载是 AR 行为;避免触发的方式是预加载或用数组自行组装。
06.5.3.7-012 with() 预加载如何消除 N+1?
一句话结论
with('关联名') 在主查询后用一次 IN 查询批量取出关联记录,按外键回填到各主模型;主记录数与关联查询数解耦,避免逐条查询。
概念解释
预加载声明可以嵌套(comments.author),一次批量取出多层关联。with 只解决读取关联,不改变主查询过滤;需要按关联筛选仍需 joinWith 或关联条件。
原理流程
- 主查询执行取出主模型集合。
- 收集主模型关联键。
- 一次查询关联表,按键分组回填到模型。
代码或图示
$posts = Post::find()->with('comments.author')->all();
foreach ($posts as $post) {
// comments 与 author 均已预加载,无额外查询
}
常见误区
- with 过多大宽表关联:单次批量查询数据量膨胀,内存与传输成本上升。
- 预加载后仍在循环里再查关联统计:未纳入 with 的关联仍触发懒加载。
追问
- with 能带关联条件吗?答:可在关联定义内带条件;需要独立条件时用
with传入回调配置,具体语法以版本为准。 - 预加载结果如何排序?答:排序声明在关联 Query 内;回填后集合顺序按关联定义排序。
06.5.3.7-013 joinWith() 与 with() 有什么区别?
一句话结论
joinWith() 在主 SQL 中 JOIN 关联表,可用于跨表条件过滤、排序与select 字段;with 只做批量预加载不改变主查询 JOIN 结构。
概念解释
需要按关联表字段筛选(如只取有审批评论的文章)或按关联字段排序时用 joinWith;纯展示关联数据用 with。joinWith 可配合 asArray 与去重避免主记录重复。
原理流程
- joinWith 把关联表 JOIN 进主查询。
- 主查询 where/orderBy 引用关联表字段。
- 可取关联预加载,或仅用 JOIN 过滤。
代码或图示
$posts = Post::find()
->joinWith('comments c')
->where(['c.status' => 'approved'])
->groupBy('post.id')
->all();
常见误区
- 一对多 JOIN 后主记录重复:需 groupBy 或去重处理。
- 用 joinWith 替代 with 做纯展示:多一次 JOIN 成本,数据量小时区别不大但语义应分清。
追问
- joinWith 能同时预加载吗?答:可配置是否连同 with 行为;默认 JOIN 参与查询,预加载开关以方法参数为准。
- 跨表字段如何加表别名?答:关联定义或查询中指定别名,避免多表同名列冲突。
06.5.3.7-014 如何按关联条件筛选主模型?
一句话结论
通过 JOIN 关联表加 where 条件,或用关联查询的 exists/子查询判断关联是否存在;纯 with 预加载不能反向过滤主记录。
概念解释
场景:“只取有评论的文章”“取评论数大于阈值的文章”。JOIN 适合简单条件,子查询 exists 适合判断存在性,聚合条件用子查询或 GROUP BY HAVING。
原理流程
- 选择 JOIN 或子查询表达关联条件。
- 条件作用于关联表字段。
- 主查询返回满足条件的主模型。
代码或图示
$hasComment = Post::find()
->where(['exists', Comment::find()->where('comment.post_id = post.id')])
->all();
常见误区
- 把过滤条件写进 with 关联定义:只影响关联集合,主记录仍全部返回。
- 一对多 JOIN 未去重:计数与列表重复。
追问
- 关联计数如何筛选?答:子查询统计评论数,HAVING 比较阈值;或在仓储层用聚合查询实现。
- 条件字段索引如何配合?答:JOIN/子查询字段应有关联索引,否则大表扫描成本高。
06.5.3.7-015 link()/unlink() 如何维护关联与外键?
一句话结论
link($关联名, $模型, $extra) 建立两模型关联:hasMany/多对多写入外键或中间表;unlink() 解除关联,按配置删除或置空外键。
概念解释
link 在事务外还是事务内取决于调用方;保存关联时需保证主模型已存在。多对多 link 写中间表记录,额外字段可通过第三参数写入。unlink 不删除关联模型本身,只断开关联。
原理流程
- 两端模型已持久化。
- link 按关联类型更新外键/中间表。
- 关联内存缓存刷新,后续访问得到新集合。
代码或图示
$post->link('tags', $tag);
$post->unlink('tags', $tag, true); // 第二参数模型,第三参数是否删除关联记录
常见误区
- 主模型未保存就 link:外键主键缺失,关联写入失败。
- 误以为 unlink 删除关联模型:标签本身仍存在,只是移除中间表/外键关联。
追问
- link 支持批量吗?答:逐个调用 link;批量建立可在服务层直接写中间表并刷新缓存。
- 关联额外字段如何写入?答:link 第三参数传中间表字段键值,具体支持以版本为准。
06.5.3.7-016 脏属性与更新过滤如何工作?
一句话结论
AR 跟踪属性原始值与当前值,更新时只写变化的脏属性;save(false) 跳过校验直接保存,updateAttributes() 限定更新指定字段,适合受控字段写入。
概念解释
脏属性对比避免整行覆盖;更新语句只包含变化列。updateAttributes 绕过安全属性与校验,只能用于内部受控场景,不能接收外部批量赋值。
原理流程
- 模型加载时记录属性原值。
- 赋值后对比得出脏属性。
- update 只写脏属性列;指定方法限定列集合。
代码或图示
$post->status = 'published';
$post->save(false); // 跳过校验直接保存脏属性
// 受控内部更新
$post->updateAttributes(['status' => 'published']);
常见误区
- 在外部请求场景用 updateAttributes:绕过 rules 安全赋值,越权风险。
- 保存后未刷新原值:同一实例再次保存可能重复提交脏值,注意实例生命周期。
追问
- 如何读取脏属性?答:模型提供 dirtyAttributes 一类访问方法,具体名称以版本为准。
- 大字段未变化也会被写入吗?答:按脏属性对比生成 UPDATE 列,未变化列不进入 SET 子句。
06.5.3.7-017 AR 生命周期事件有哪些?
一句话结论
AR 提供 afterFind、beforeValidate/afterValidate、beforeSave/afterSave、beforeInsert/afterInsert、beforeUpdate/afterUpdate、beforeDelete/afterDelete 等事件节点,可挂行为或处理器做审计、时间戳、级联。
概念解释
before 类事件可中止流程(标记 handled/返回 false,以版本实现为准);after 类事件在数据库操作完成后触发,适合记录日志、发通知。事件 sender 为模型实例。
原理流程
- 查询命中触发 afterFind。
- 保存前后触发校验与 insert/update 事件。
- 删除前后触发删除事件,审计逻辑挂 after 节点。
代码或图示
public function behaviors()
{
return [
'ts' => \app\behaviors\TimestampBehavior::class,
];
}
常见误区
- 在 afterSave 里再 save 当前模型:递归触发保存事件,可能造成循环。
- beforeDelete 做级联删除却不控制事务:主记录删除成功、级联失败导致不一致。
追问
- 事件如何中止保存?答:beforeSave 事件可通过返回值或 handled 标记中止,具体机制以 AR 基类文档为准。
- 批量插入会逐条触发事件吗?答:AR 逐条 save 触发;批量命令(Command 批量插入)不经过 AR 事件。
06.5.3.7-018 AR 层如何使用乐观锁与悲观锁?
一句话结论
乐观锁通过版本字段在 UPDATE 时带版本条件,影响行数为 0 说明并发冲突;悲观锁在事务内 for update 锁定行,阻塞其他事务修改,按冲突频率选择策略。
概念解释
乐观锁适合冲突少的场景,无阻塞、需重试;悲观锁适合写冲突激烈的短事务,锁定期间占用连接。AR 可声明版本字段,查询构造器支持锁子句,具体 API 以版本为准。
原理流程
- 读取记录与版本号。
- 提交时 UPDATE ... WHERE 主键与版本号匹配。
- 影响行数 0 则重读并重试;悲观锁在事务内 SELECT ... FOR UPDATE。
代码或图示
// 乐观锁思路:更新时携带版本条件
$affected = Post::updateAll(
['status' => 'published', 'version' => new \yii\db\Expression('version + 1')],
['id' => $post->id, 'version' => $post->version]
);
常见误区
- 乐观锁冲突不重试:直接报错或覆盖,丢失并发更新。
- 长事务使用悲观锁:锁持有过久,连接与吞吐量下降。
追问
- AR 如何声明乐观锁字段?答:基类提供乐观锁属性配置能力,具体属性名与行为以版本文档为准,不确定时核对源码。
- 锁与事务边界关系?答:锁必须在事务内获取与释放,事务提交/回滚后锁释放。
06.5.3.7-019 Yii 3.0 对 ActiveRecord 边界有什么调整?
一句话结论
3.0 建议把校验、表单场景、授权、通知从 AR 类拆到 FormModel、Validator 与服务;AR(yiisoft/active-record)聚焦表映射、属性与关联,持久化也可由 Repository + yiisoft/db 替代。
概念解释
2.x AR 常承载校验、表单、业务逻辑等多重职责;3.0 升级路径推荐服务/领域对象 + 仓储边界,AR 仅作增量方案。校验规则移到表单模型或命令对象,再把合法数据写入记录。
原理流程
- 表单模型收集输入并校验。
- 服务把合法数据映射到 AR/领域对象。
- 仓储负责持久化,AR 只承担表映射与关联。
代码或图示
// 3.0 思路:校验与记录分离
final class PostInput extends \Yiisoft\FormModel\FormModel
{
#[\Yiisoft\Validator\Rule\Required]
public ?string $title = null;
}
常见误区
- 把 2.x AR 的 rules() 整体搬进 3.0 记录类:3.0 校验归属表单模型/验证器,记录类不承载校验。
- 领域逻辑继续挂在记录保存事件里:跨边界耦合,测试与替换存储困难。
追问
- 3.0 是否必须放弃 AR?答:不是,可选安装 active-record 包;复杂业务推荐 Repository 与领域对象方案。
- 关联能力在 3.0 保留吗?答:active-record 包提供关联与预加载;纯 db 查询构造器不承担 AR 实例化。
06.5.3.7-020 常见误区:批量赋值绕过与关联预加载误用
一句话结论
高频问题包括:把敏感字段放进可赋值集合、用 attributes 直接覆盖输入、列表循环懒加载、with 嵌套层级失控、JOIN 未去重、跨表条件作用阶段混淆。
概念解释
评审模型时核对场景字段白名单、rules 覆盖、列表查询预加载清单、JOIN 去重与索引;外部输入一律走 load + validate,内部受控更新走指定方法。关联数据访问路径在代码评审中明确是懒加载还是预加载。
原理流程
- 核对场景与安全字段,排除 id/归属/权限字段。
- 列表查询检查 with 声明与 N+1。
- JOIN 查询核对去重、别名与索引。
代码或图示
// 自检清单(示意)
// [x] 外部输入走 load + validate
// [x] 列表 with 所需关联
// [x] JOIN 结果已 groupBy 去重
// [ ] 关联额外字段已经中间模型处理
常见误区
- 新增字段忘记加入 rules:批量赋值时该字段不更新,表现为“保存无效”。
- 预加载关联名拼写错误:运行期抛关联未定义异常,应在测试中覆盖列表场景。
追问
- 如何定位 N+1?答:开启数据库日志统计 SQL 条数,循环内出现同结构关联查询即为懒加载触发。
- 模型字段与表结构不同步怎么办?答:更新迁移后刷新 Schema 缓存;字段缺失时实例属性与数据库列错位。