ThinkPHP模型自动写入作者ID方法

ThinkPHP 6 已彻底移除旧版的 $auto 和 $_auto 自动完成机制，导致许多开发者发现配置创建者/更新者 ID 时“写了却没反应”——既不生效也不报错；本文直击痛点，详解两种可靠替代方案：一是通过规范命名的字段修改器（如 setCreateUserIdAttr）安全注入当前登录用户 ID，并巧妙利用 $this->origin 判断新增/更新场景避免覆盖；二是借助 beforeWrite 钩子实现更灵活、统一的上下文控制，同时强调所有自动写入逻辑仅在模型 save()/create() 中有效，一旦绕过模型直接使用 Db 类操作，ID 将完全不会被填充——帮你避开静默失效的坑，真正落地可维护的权限归属追踪。

ThinkPHP 模型不支持开箱即用的「自动写入创建者/更新者 ID」，必须手动干预；TP6 已彻底移除 $_auto 机制，TP5.1+ 中该功能也已废弃，硬配会静默失效。

为什么 $auto 或 $_auto 配置没反应

TP6 完全删除了模型层的 $_auto、$auto、$filter 等旧式自动完成配置项。哪怕你在模型里写了：

protected $auto = ['create_user_id', 'update_user_id'];

它也不会执行，也不报错——直接跳过。这是设计上的移除，不是 bug。

常见错误现象包括：

• 数据库字段有值，但模型 save() 后仍是 NULL
• 调试发现 onBeforeInsert 根本没调用
• 控制器里调 $model->save()，但 create_user_id 始终没被赋值

正确做法：用修改器（Mutator）写入当前登录用户 ID

修改器是目前最稳定、可复用、且符合 TP6 架构的方式。它在字段写入前触发，能安全获取当前用户上下文。

示例（假设你用 think\facade\Auth 或自定义登录态）：

public function setCreateUserIdAttr($value)
{
    return $value ?: Auth::id();
}

public function setUpdateUserIdAttr($value)
{
    return $value ?: Auth::id();
}

注意点：

• 方法名必须是 set + 字段名首字母大写 + Attr，比如字段叫 create_user_id，就得写 setCreateUserIdAttr
• 修改器只对 save()、create() 生效；Db::table()->update() 或 where()->update() 完全绕过，不会触发
• 若 Auth::id() 可能为 null（如 CLI 环境或未登录），需自行兜底，比如返回 0 或抛异常

更新时只改 update_user_id，不碰 create_user_id

默认情况下，修改器对新增和更新都生效。但 create_user_id 一旦写入就不该再变，否则可能被覆盖。需加判断：

public function setCreateUserIdAttr($value)
{
    // 新增时才写入，更新时不干预
    if (is_null($this->origin['id'])) {
        return $value ?: Auth::id();
    }
    return $this->origin['create_user_id'] ?? $value;
}

public function setUpdateUserIdAttr($value)
{
    return $value ?: Auth::id();
}

关键逻辑：

• $this->origin['id'] === null 表示是新增操作（主键尚未入库）
• $this->origin 是原始数据库数据，仅在更新时存在；新增时为空数组
• 别依赖 $this->data['id'] 判断，它可能已被手动设值，不可靠

更稳妥的方案：在 beforeWrite 钩子里统一处理

如果你需要更精细控制（比如区分「管理员代操作」或记录操作类型），推荐用 beforeWrite 钩子。它比修改器更早执行，且能访问完整上下文。

protected function beforeWrite()
{
    if (is_null($this->origin['id'])) {
        $this->data['create_user_id'] = Auth::id() ?: 0;
        $this->data['create_time'] = date('Y-m-d H:i:s');
    } else {
        $this->data['update_user_id'] = Auth::id() ?: 0;
        $this->data['update_time'] = date('Y-m-d H:i:s');
    }
}

注意：

• 必须显式调用 parent::beforeWrite()（如果父类有实现），否则可能破坏时间戳等内置逻辑
• 不要在钩子里做耗时操作（如查库、HTTP 请求），它在事务内执行
• 若你重写了该方法但忘了调 parent::beforeWrite()，整个自动写入链就断了——create_time 和 update_time 都不会生效

真正容易被忽略的是：所有这些逻辑，都只在模型方法（save/create）中生效；一旦你用 Db::name('user')->insert() 或 UserModel::where(...)->update()，就彻底脱离模型生命周期——ID 字段不会自动填，连报错都不会有。

以上就是《ThinkPHP模型自动写入作者ID方法》的详细内容，更多关于的资料请关注golang学习网公众号！