ThinkPHP模型字段格式化应只在getAttr中做展示层转换并判断查询上下文，append属性需严格匹配方法名且避免与数据库字段同名，toJson()需干预序列化过程，导出Excel时须显式触发格式化。
模型字段自动转义输出时，getAttr 和 setAttr 怎么写才不踩坑
ThinkPHP 模型字段格式化输出的核心是重写 getAttr，但很多人直接在里头做字符串拼接或时间转换，结果导致 where 查询失效、JSON 序列化异常、或字段被重复处理。
真正安全的做法是：只在 getAttr 中做「展示层转换」，且必须判断当前是否处于查询上下文（比如是否正在构建 SQL）。
- 用
$this->data或$this->origin判断原始值是否存在，避免递归调用 - 对日期字段，优先用
Carbon::parse($value)->format('Y-m-d')而非date('Y-m-d', strtotime($value))，后者在时区/空值下容易出错 - 金额字段别在
getAttr里加千分位或货币符号——前端或视图层处理更可控；后端只负责统一转为两位小数的float或字符串 - 如果字段可能为空（
null或''），一定要先判空再处理，否则Carbon::parse(null)会抛InvalidArgumentException
为什么 append 属性 + getxxxAttr 方法组合经常失效
很多人想给 price 字段附加一个 price_format 属性，于是定义 getPriceFormatAttr 并加到 append 数组里，结果发现 API 返回里没有这个字段，或者值是 null。
根本原因是：ThinkPHP 的 append 只在模型被序列化（如 toArray()、toJson()）时触发，而 getxxxAttr 方法名必须严格匹配 append 中的字段名（不含下划线驼峰转换），且不能和数据库字段同名。
立即学习“PHP免费学习笔记（深入）”；
-
append = ['price_format']→ 对应方法必须叫getPriceFormatAttr，不是getPriceFormatAttr也不是getPrice_formatAttr - 如果数据库已有
price_format字段，该append会被忽略——TP 优先取真实字段值 - 若模型用了
hidden或visible，确保price_format没被意外过滤掉 - 调试时可用
dump($model->append(['price_format'])->toArray())强制触发，确认逻辑是否执行
toJson() 输出金额/日期时丢失精度或格式错乱
直接调用 $model->toJson() 后发现金额变成 199.99999999999997，或日期变成时间戳而非字符串，这不是 TP 的 bug，而是 PHP 原生 JSON 编码行为。
ThinkPHP 默认用 PHP 内置 json_encode，它对 float 不保留小数位，对 DateTime 对象默认转时间戳。要控制输出，得干预序列化过程。
- 金额字段建议在
getAttr中统一转成字符串：number_format($value, 2, '.', '')，避免浮点误差 - 日期字段不要返回
Carbon实例，而应返回格式化后的字符串（如$value->toDateString()），否则json_encode仍可能吐时间戳 - 如需全局控制，可重写模型的
jsonSerialize()方法，但注意兼容性：TP 6.0+ 支持，5.x 需手动处理 - 别依赖
dateFormat配置项——它只影响datetime类型字段的数据库读写，不影响json输出
批量导出 Excel 时日期/金额格式突然还原成原始值
Web 页面上看着好好的 2024-03-15 和 ¥199.00，一导出 Excel 就变回 2024-03-15 10:22:33 和 199，这是因为导出逻辑通常绕过了模型的 getAttr，直接读 $model->getData() 或 $model->toArray(false)。
导出本质是数据搬运，不是视图渲染，所以所有格式化逻辑得显式调用，不能依赖模型自动触发。
- 导出前先调用
$model->append(['date_format', 'price_format'])，再toArray() - 更稳妥的方式是用
collection($list)->map(function ($item) { return $item->only(['id', 'date_format', 'price_format']); }) - 如果用 PhpSpreadsheet，别把模型对象直接塞进单元格；先
toArray(true)（强制触发 getAttr），再写入 - 注意
toArray(false)会跳过所有访问器，这是最常被忽略的开关
