ThinkPHP中ENUM字段取出来是字符串而非可读名，因PDO底层直接返回原始值（如'draft'），TP默认不转换；需手动定义获取器getStatusTextAttr并配合常量STATUS_MAP实现映射。
ThinkPHP模型里ENUM字段为什么取出来是字符串而不是可读名
因为数据库原生ENUM类型在PDO底层返回的就是字符串值（比如'draft'），TP默认不做转换。你看到的不是“没映射”，而是根本没定义映射逻辑。
常见错误现象：$article->status直接输出'draft'，但业务代码里想写$article->status_text === '草稿'——这会报错或始终为false。
- 必须手动定义获取器（accessor），不能依赖TP自动识别
ENUM - 获取器名要和字段名严格对应，比如字段叫
status，获取器就得叫getStatusTextAttr - TP6中获取器函数参数是
$value, $data，其中$value是原始数据库值（'draft'），$data是整行数据，可用于关联判断
protected function getStatusTextAttr($value, $data)
{
$map = [
'draft' => '草稿',
'publish' => '已发布',
'delete' => '已删除',
];
return $map[$value] ?? '未知';
}
用类常量统一管理ENUM映射容易踩的坑
把ENUM值和中文名写死在获取器里，后期改一个就要翻模型文件；更糟的是，控制器/验证器里可能重复写['draft', 'publish']这种数组，一改全崩。
正确做法是：在模型里定义protected const STATUS_MAP，并在获取器中复用它。
立即学习“PHP免费学习笔记（深入）”；
- 常量必须是
protected或public，private会导致子类无法继承映射逻辑 - 键名必须和数据库存储值完全一致（大小写敏感），
'Draft'≠'draft' - 不要在常量里写业务逻辑（比如
self::STATUS_MAP[$value]['color']），TP获取器只应做简单映射，复杂逻辑放服务层
protected const STATUS_MAP = [
'draft' => '草稿',
'publish' => '已发布',
'delete' => '已删除',
];
protected function getStatusTextAttr($value, $data)
{
return self::STATUS_MAP[$value] ?? '未知';
}
写入时如何确保传入的是合法ENUM值
获取器只管读，不管写。用户提交status=草稿，直接赋值$model->status = '草稿'会导致写入失败或被截断（MySQL严格模式下报错Incorrect integer value）。
解决方案不是改数据库，而是加一个「写入转换」：用修改器（mutator）把中文名转回ENUM键。
- 修改器名格式为
set{Field}Attr，比如setStatusAttr - 注意区分：获取器处理读，修改器处理写；两者不互逆，也不强制成对出现
- 如果前端传的是
status_text字段，那就得额外定义setStatusTextAttr，但通常建议前端传标准值（'draft'），后端只做校验
protected function setStatusAttr($value)
{
// 允许传入中文名或英文键，都转成英文键存库
$reverseMap = array_flip(self::STATUS_MAP);
return $reverseMap[$value] ?? $value;
}
TP6+中用type配置让ENUM字段自动转整型？别试了
有开发者看到TP文档里type支持integer，就给status字段配'type' => 'integer'，指望它把'draft'转成0。结果发现：TP的type只对数字字符串有效（如'123'→123），对ENUM无效，且MySQL的ENUM索引从1开始，0还是非法值。
真正该做的，是放弃“自动转换”幻想，老老实实走获取器+常量路线。
-
type配置对ENUM字段无实际作用，删掉省得误导 - 如果真需要数字码，就在
STATUS_MAP里显式定义键为整数：1 => '草稿'，再配合array_search()反查 - 跨模型复用映射？抽成trait，但别用
static::STATUS_MAP——静态绑定会出错，改用self::STATUS_MAP并确保trait在模型里正确引入
最麻烦的其实是前后端约定：数据库存什么、API返回什么、前端下拉选项用什么key——这些不统一对齐，光靠模型一层怎么写都是补丁。
