ThinkPHP5修改器怎么用_ThinkPHP5模型修改器数据预处理【模型】-ThinkPHP-PHP中文网

thinkphp5修改器仅在模型save()等完整写入链路中触发，命名须为set+字段驼峰+attr且为protected方法；db::insert()等绕过模型的操作不生效，修改器不参与查询匹配。

thinkphp5修改器怎么用_thinkphp5模型修改器数据预处理【模型】

ThinkPHP5 的修改器（setXxxAttr）只在模型写入流程中生效，直接调用 Db::insert() 或 $model->insert() 不会触发——这是绝大多数人踩坑的第一步。

修改器命名和定义位置

必须定义在模型类（继承 think\Model）内部，方法名严格遵循 set + 字段名（驼峰） + Attr 规则，且为 protected 方法：

password 字段 → 方法名是 setPasswordAttr
create_time 字段 → 方法名是 setCreateTimeAttr（不是 setCreate_timeAttr）
字段名必须真实存在于数据表中，否则修改器值不会写入数据库（仅影响内存中的模型数据）

哪些操作能触发修改器

只有走模型完整写入链路的操作才会调用修改器，常见有效场景包括：

模型赋值后调用 save()：$user = new User(); $user->password = '123456'; $user->save();
批量传参调用 save()：$user->save(['password' => '123456', 'name' => 'Tom']);
使用 data() 并传 true：$user->data(['password' => '123456'], true); $user->save();
显式调用 setAttr()：$user->setAttr('password', '123456');

⚠️ 注意：$user->insert($data)、Db::name('user')->insert($data)、Db::execute() 等绕过模型的写入方式，完全不触发任何修改器。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

修改器函数参数的实际含义

setXxxAttr($value, $data) 的第二个参数 $data 是当前模型已收集的全部字段数据（可能已被其它修改器处理过），不是原始输入值：

protected function setPasswordAttr($value, $data)
{
    // $data 包含 name、email 等所有已设置字段（含已被修改器处理过的）
    // 所以可安全依赖其它字段做组合逻辑，比如：
    return md5($value . ($data['salt'] ?? 'default_salt'));
}

若字段未定义在 $data 中（如 $data['salt'] 为空），不能假设它一定存在
不要在修改器里调用 $this->save() 或其它写库操作，会引发递归或事务异常
时间类字段建议统一转为时间戳：return strtotime($value);，避免类型不一致导致数据库报错

常见错误：加密后查不到、状态字段失效

典型表现是数据存进去了，但后续用 User::where('password', $input)->find() 查不到——因为查询时没做反向解密：

修改器只管「写入前」处理，不自动影响「查询条件」或「where」匹配逻辑
密码类字段应配合查询封装，例如定义一个 login($account, $pwd) 方法，在内部对 $pwd 做同样加密再查库
状态字段（如 status）若用修改器转成数字，确保前端传值和数据库约束一致（比如传字符串 'normal' 进来，修改器转 1；但查询时不能直接 where('status', 'normal')）

真正容易被忽略的是：修改器执行顺序不可控，多个字段间有依赖时（如 setTokenAttr 依赖 $data['password']），必须确保依赖字段的修改器先被调用——TP5 不保证执行顺序，稳妥做法是把组合逻辑收拢到单个修改器里，或改用 auto 自动完成 + 事件钩子。