ThinkPHP查ENUM字段返回数字而非文字，因其不自动解析ENUM语义，需通过访问器getStatusTextAttr()映射为中文，并用状态常量和静态方法统一管理转换逻辑。
ThinkPHP里用enum字段存状态，为什么查出来是数字而不是文字？
因为数据库的ENUM类型本质还是字符串枚举，但MySQL在某些模式下（比如严格模式关闭）会把非法值转成空字符串或默认值，而ThinkPHP默认不主动映射ENUM值到语义化标签——它只当普通字段读，原样返回数据库存的值（比如'draft'或0，取决于你定义方式和MySQL行为）。
常见错误现象：select * from article查出status字段是1，但业务里要显示“已发布”，却得在每个foreach里写if-else判断。
- 别直接依赖MySQL的
ENUM做语义管理，ThinkPHP不自动解析它的含义 - 建表时建议用
TINYINT+ 注释说明，更可控；如果非要用ENUM，确保MySQL开启STRICT_TRANS_TABLES，避免隐式转换 - 在模型里统一处理：用
getAttr访问器把数字/字符串转成中文，例如getStatusTextAttr()
ThinkPHP模型里怎么安全地定义状态常量和映射？
硬编码if($status === 1) return '草稿'会导致散落在模板、控制器、API返回里，改一个地方漏十个。正确做法是在模型类里集中声明，并通过访问器或静态方法暴露。
使用场景：列表页展示状态文字、API返回status_text字段、搜索条件支持中文别名（如where('status_text', '已发布')）。
立即学习“PHP免费学习笔记（深入）”；
- 在模型中定义
protected $statusMap = [0 => '草稿', 1 => '已发布', 2 => '已归档']，注意键必须跟数据库存的值一致（数字 or 字符串） - 写
getStatusTextAttr()访问器，内部用$this->statusMap[$value] ?? '未知'，避免Notice: Undefined index - 如果需要反向查（根据文字找数字），加个静态方法
getStatusValueByLabel(string $label): ?int，里面用array_search()，记得trim()输入防止空格干扰
用where('status', 'draft')查不到数据？检查这三点
这是典型的数据类型错配：数据库字段是TINYINT，但代码里传了字符串'draft'，ThinkPHP不会自动帮你转——它原样拼SQL，结果变成WHERE status = 'draft'，而MySQL会把字符串强转成0，导致误匹配。
错误现象：Article::where('status', 'draft')->find()返回null，但where('status', 0)能查到。
- 确认数据库字段类型：用
SHOW COLUMNS FROM article LIKE 'status'看是不是TINYINT或ENUM，别凭印象 - 查状态时统一用数字：前端传参也应校验为整型，或在控制器里用
intval()兜底 - 如果非要支持字符串查询（比如API兼容旧调用），在查询前手动映射：
$map = ['draft' => 0, 'published' => 1]; $status = $map[$input] ?? null;
状态变更逻辑放哪？事务里更新+日志+通知怎么组织？
状态不是孤立字段，往往伴随权限校验、时间戳更新、关联记录同步（比如发布文章要生成首页缓存）、甚至发消息通知。全堆在控制器里，很快变面条代码。
性能影响：每次状态变更都去查一遍用户权限、再查一遍当前状态是否允许跳转，没缓存的话容易拖慢接口。
- 把状态流转规则封装进模型方法，例如
publish(): bool，内部先if ($this->status !== self::STATUS_DRAFT) return false; - 用
Db::transaction()包裹更新、日志写入（status_log表）、缓存清理，失败则全部回滚 - 别在模型里直接调通知服务（如邮件、IM），用事件机制：
event('article.published', $this)，解耦且方便测试
最容易被忽略的是状态机约束——比如“已归档”不能退回“草稿”，这种规则一旦漏掉，线上就可能产生脏数据。建议用thinkphp/extend里的StateMachine扩展，或者自己维护一张status_transition配置表，每次变更前查表校验。
