ThinkPHP 的 Model 不自动转换 ENUM 字段，因其不解析数据库元信息；需用 getStatusTextAttr 获取器映射原始值为中文，并用 setStatusAttr 修改器校验写入值，命名须严格匹配字段名。
ThinkPHP 的 Model 中没有内置的 type 字段用于枚举类型自动转换，枚举（ENUM）字段不会被框架自动识别或映射为可读名。它在 PDO 层直接返回原始字符串值（如 'draft'、'published'），必须手动配置才能实现“取出来是中文、写进去校验合法”的效果。
为什么 ENUM 字段不自动转？
数据库的 ENUM 是一种约束型字符串类型，TP 不解析其定义，也不读取表结构元信息。无论你定义的是 ENUM('draft','published') 还是 ENUM('草稿','已发布')，查出来的始终是数据库存储的原始值——框架不做任何隐式转换。
正确做法：用获取器（accessor）做映射
在模型中定义与字段名匹配的获取器方法，把原始值转成业务可读内容：
- 字段名为
status，则定义getStatusTextAttr() - 方法接收两个参数：
$value（当前字段原始值）和$data（整行数据数组） - 配合常量数组统一管理映射关系，避免硬编码
示例：
protected $statusMap = [
'draft' => '草稿',
'published' => '已发布',
'closed' => '已关闭',
];
public function getStatusTextAttr($value, $data)
{
return $this->statusMap[$data['status']] ?? '未知状态';
}
写入时如何校验和转换？
获取器只管读，写入需靠修改器（mutator）或业务层控制：
- 定义
setStatusAttr($value)，对传入值做合法性判断和标准化 - 支持传入中文、英文标识、数字等多种形式，统一转为数据库接受的值
- 非法值可抛异常或设默认值，避免静默失败
示例：
public function setStatusAttr($value)
{
$map = array_flip($this->statusMap); // 反向映射
if (isset($map[$value])) {
return $map[$value];
}
if (is_numeric($value)) {
$keys = array_keys($this->statusMap);
return $keys[$value] ?? 'draft';
}
return 'draft';
}
别踩这些坑
- 获取器名必须严格对应字段名 +
TextAttr后缀，status→getStatusTextAttr，错一个字母都不触发 - 数据库字段名是
user_status，那获取器就得叫getUserStatusTextAttr，不是getStatusTextAttr - 不要依赖
$type配'status' => 'string'或类似写法——它对 ENUM 映射完全无效 - 前端传
status: "草稿"直接save()不会走修改器，必须先赋值再保存：$model->status = '草稿'; $model->save();
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
