ThinkPHP关联模型自动写入与更新该如何使用【模型】

ThinkPHP关联模型无自动写入开关，需显式配置：一对一用save()需主模型已存在且非null；一对多须遍历调用关联save()；字段联动靠修改器；批量操作绕过模型逻辑。

ThinkPHP 的关联模型没有“自动写入/更新”的魔法开关，所谓“自动”必须靠显式配置和正确调用方式来实现。核心原则是：主从模型分开处理、时间戳和业务字段靠修改器或钩子控制、批量操作绕过模型逻辑——理解这点，才能避免静默失败或数据不一致。

一对一关联的写入与更新

hasOne 和 belongsTo 类型支持直接写入，但需满足前提条件：

• 主模型必须已存在（有主键），否则外键无法填充；新建主模型后，要先 save() 成功，再调用关联 save()
• 关联方法返回的是单个模型对象（如 $user->profile()），不是集合，所以能调 save()
• 传数组即可：$user->profile()->save(['email' => 'a@b.com'])，框架会自动补 user_id
• 若关联记录不存在，$user->profile 返回 null，直接调 save() 会报错；应改用 $user->profile()->create([...]) 或先判空再创建

一对多关联不能直接 save()

hasMany 或 belongsToMany 返回的是 Collection 对象，本身没有 save() 方法。常见错误是写 $user->comments->save()，这会直接报错。

• 正确做法是遍历每条数据，用关联关系对象逐条保存：$user->comments()->save($comment)
• 不要用 Db::table()->insertAll() 手动补外键——会跳过验证、事件、时间戳等模型逻辑
• 性能敏感场景可用 Comment::insertAll($data)，但必须显式传 user_id，且不触发关联生命周期

关联字段联动靠修改器，不是自动完成

状态码转文字、金额存整数、登录用户 ID 写入等，都不能依赖旧版 $_auto（TP6 已移除），必须用修改器（Mutator）：

立即学习“PHP免费学习笔记（深入）”；

• 字段名是 status_text，就定义 setAttrStatusText()，在写入前加工值
• 若字段依赖其他字段（如 status 改变时同步 status_text），应在 setAttrStatus() 里同时设置两个字段，注意避免递归调用
• 派生字段设为只读：protected $readonly = ['status_text']，防止被外部覆盖
• 创建者/更新者 ID 同理：setCreateUserIdAttr() 和 setUpdateUserIdAttr() 中调用 Auth::id()

批量更新和复杂条件必须绕开模型

saveAll() 不走模型生命周期，所有修改器、事件、时间戳都失效；where()->update() 也不触发任何模型逻辑。

• 批量更新关联表（如多个用户的 profile）：用 Db::table('profile')->whereIn('user_id', $ids)->update([...])
• 带关联条件的更新（如“把所有认证过的用户 status 改为 2”）：必须手写 join：Db::table('user')->alias('u')->join('profile p', 'u.id = p.user_id')->where('p.verified', 1)->update(['u.status' => 2])
• 涉及计算或 JSON 字段更新（如 score = score + 10 或 JSON_SET(config, '$.theme', 'dark')）：必须用 Db::raw()