ThinkPHP字段映射找不到_ThinkPHP模型Map属性详解【技巧】-ThinkPHP-PHP中文网

字段映射需显式配置，tp默认下划线转驼峰但易失效；表名须设$table或$name，否则静默错表；fieldmap可实现双向映射，需重写getattribute/setattribute；enum需严格匹配大小写的获取器；hidden仅作用于已查出的原始字段，不影响查询、append及关联字段。

thinkphp字段映射找不到_thinkphp模型map属性详解【技巧】

字段映射在 ThinkPHP 里不是“开了就自动好使”的功能，它依赖显式配置、命名约定和上下文判断。没效果时，大概率是字段名被转换丢了、映射逻辑没触发，或根本没走模型层。

TP 默认把 UserModel 映射成表名 user_model，但你实际表可能是 user 或 tp_user。不设 $table（TP6）或 $name（TP5.1+），查询会静默命中错误表，返回空数组，且无任何报错提示。

TP6 中用 protected $table = 'user'; 最直接，比靠前缀拼接更可靠
若用 __table 静态属性，必须确保它在 initialize() 执行前已存在，否则会被忽略
关闭 db.fields_strict 或调用 field(true) 会跳过字段校验，但也会让下划线→驼峰转换失效，尤其当字段含大写字母（如 APIKey）时
验证方式：查出数据后，用 $user->getData('last_login_time') 能拿到值，但 $user->last_login_time 为空——说明字段键被转换机制吃掉了

TP 原生不支持字段名到数据库列名的双向映射，getAttr 只管读取后的加工，不管原始字段怎么从结果集里捞出来。真要映射，得像 Laravel 那样手动接管属性访问逻辑。

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

下载

在模型中定义 protected $fieldMap = ['name' => 'user_name', 'status' => 'is_active'];
重写 getAttribute($key)：若 $key 在 $fieldMap 里，就去取 $this->getAttribute($fieldMap[$key])
重写 setAttribute($key, $value)：同样先查 $fieldMap，再调用父类 setAttribute 写入真实字段名
注意：$fillable 必须填逻辑字段名（如 name），不是数据库字段名（user_name），否则 create() 或批量赋值会失败

PDO 返回的就是原始 ENUM 字符串，TP 不会自动翻译。看到 $article->status === 'draft' 是正常的；想得到中文，必须写获取器，且键名必须和数据库存储值**完全一致**（包括大小写）。

获取器名必须是 getStatusTextAttr（字段名 + Text + Attr），不能是 getStatusAttr
推荐用类常量统一管理映射：protected const STATUS_MAP = ['draft' => '草稿', 'publish' => '已发布'];
获取器里用 self::STATUS_MAP[$value] ?? '未知'，避免硬编码散落在各处
写入时不能只靠获取器——用户提交“草稿”，得配一个 setStatusAttr 修改器，把它转回 'draft' 再入库

hidden 只在模型序列化（toArray()、toJson()）时起作用，且只过滤**已加载的原始字段**。它对数据库查询本身、关联字段、append 字段完全无效。

如果查询时没写 field(['id','name','email'])，而 email 不在 hidden 列表里，它压根不会进模型实例，自然也轮不到 hidden 处理
append 字段（比如 getAgeTextAttr）默认不受 hidden 控制，要隐藏就得在对应获取器里加逻辑，或改用 visible
关联模型的字段不会被父模型的 hidden 过滤，得在关联模型里单独设
导出 Excel 或 API 返回原始数组时，hidden 不起作用，得用 array_diff_key($data, array_flip(['password', 'salt'])) 手动剔除