ThinkPHP获取器与修改器_getAttr、setAttr自动处理字段【教程】

ThinkPHP里的getAttr和setAttr，并不是那种你主动去调用的函数，而是模型自动触发的一套约定方法。换句话说，只要命名写对、位置放对，框架就会在读数据或写数据的时候，悄悄帮你把字段处理掉。但问题也恰恰出在这里——但凡有一个字母写错，或者漏掉了那个关键的Attr后缀，它就不会生效，连个报错都不会给。

获取器 getFieldNameAttr 怎么写才有效

获取器只在数据读取后触发，什么时机触发？$user->status、$user->toArray()、$user->toJson()这些操作才会调用它。它不是个万能钩子，原始的SQL查询或者Db::table()这种原生操作，它是不会掺和的。

怎么写才有效？方法名必须严格遵循get + 字段名驼峰化 + Attr的格式。举个例子，数据库字段叫user_status，那就得写成getUserStatusAttr。第一个参数$value是数据库里取出来的原始值，可能是null；第二个可选参数$data是整行数据的数组，适合做那种依赖其他字段的逻辑，比如用getFullnameAttr去拼接$data['first_name']和$data['last_name']。

要是遇到虚拟字段，比如getAgeAttr这种本身在数据库里不存在的字段，$value基本就没意义了，直接忽略，靠$data来计算就行。

如果想绕过获取器拿原始值？别费劲，直接用$user->getData('status')或者$user->getData()就好。

修改器 setFieldNameAttr 什么情况下会失效

修改器的触发条件更苛刻——它只在模型写入流程中生效。像where()->update()、Db::name()->update()这种原生更新，完全跳过了模型层，setAttr一个字都不会执行。

真正有效的触发场景是这些：$user->sa ve()、User::create([...])、$user->data([...], true)、$user->appendData([...], true)。方法签名和获取器一样：set + 驼峰字段名 + Attr，比如setPasswordAttr处理password字段。

参数$value就是你就赋的那个值（比如$user->password = '123456'），返回值才是最终入库的内容。如果想设默认值——比如空的时候填当前时间——可以写成return $value ?: date('Y-m-d H:i:s');。

需要特别提醒的是：TP6已经不再支持auto数组或_validate，那些老教程里的配置项已经彻底移除，写了也没用。

WithAttr 动态获取器优先级比模型定义高

控制器里用WithAttr可以临时覆盖模型中已有的获取器逻辑。这个功能在同一个字段需要不同接口处理不同格式的场景下特别实用——典型的就是管理后台要展示完整邮箱，APP接口却需要掩码显示。

用法也很直接：User::withAttr('email', fn($v) => substr($v, 0, 3) . '***@' . explode('@', $v)[1])->select()。它只影响本次查询结果，不会动模型本身。而且注意，它只对查询链式调用有效，如果你User::find(1)之后再去调withAttr，那是没用的。

另外还有个细节：如果模型本身没定义getEmailAttr，withAttr依然会生效；但如果两者都存在，withAttr的回调一定优先生效。

最容易被忽略的一点：字段名和方法名的驼峰转换必须严格匹配数据库实际的字段。比如create_time就要写成getCreateTimeAttr，少个C，或者多了一个下划线，都会静默失败。所以调试的时候，别光顾着看逻辑，先老老实实核对一下方法名的拼写和大小写。