ThinkPHP5修改器仅在模型save()等完整写入链路中触发，命名须为set+字段驼峰+Attr且为protected方法；Db::insert()等绕过模型的操作不生效，修改器不参与查询匹配。
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() 等绕过模型的写入方式，完全不触发任何修改器。
立即学习“PHP免费学习笔记（深入）”；
修改器函数参数的实际含义
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 自动完成 + 事件钩子。
