thinkphp6金额获取器应返回标准两位小数字符串如"1234.56"，需判空、统一转字符串再格式化、禁用货币符号与千分位，配合$append实现原始值与格式化值并存，并确保tojson()不丢失精度。
ThinkPHP6模型中对金额字段做获取器（getAttr）格式化，核心目标是：**保证展示层统一、避免浮点误差、不干扰查询与序列化逻辑**。不能把格式化写成“一劳永逸”的字符串拼接，而要分清「存储值」「原始值」「展示值」三层语义。
金额获取器必须判空且转字符串
数据库中的金额字段推荐用 DECIMAL(10,2) 类型，PDO 默认查出的是字符串（如 "199.99"），但某些配置下也可能返回 float，导致精度丢失。获取器里不要直接用 (float)$value 或 number_format($value, 2)，而应：
- 先判断是否为空：
if ($value === null || $value === '' || $value === '0')，返回'0.00'或null视业务而定 - 统一转为字符串再格式化：
number_format((float) $value, 2, '.', '')，确保小数位强制补零 - 避免使用
sprintf('%.2f', $value)，它对0.29这类值可能输出0.28999999999999998
别在获取器里加货币符号或千分位
¥、$、逗号分隔符属于视图层职责。后端获取器只负责输出标准两位小数的纯数字字符串，例如 "1234.56"，而非 "¥1,234.56"。原因有三：
- 前端可能需要该数值参与计算（如加减、汇总），带符号/逗号会增加解析成本
- 国际化场景下，符号和分隔符规则随 locale 变化，后端硬编码不灵活
- 导出 Excel 或生成 PDF 时，格式需求往往不同，混在一起会导致逻辑耦合
配合 append 实现多格式并存
如果接口既要返回原始金额（供计算），又要返回格式化金额（供展示），不要覆盖原字段，而是新增虚拟字段：
- 在模型中定义：
protected $append = ['amount_formatted']; - 对应方法名必须严格匹配：
public function getAmountFormattedAttr($value, $data) - 方法内取原始字段：
$raw = $data['amount'] ?? 0;，再格式化返回 - 确保数据库无
amount_formatted字段，否则 TP 会优先取真实字段值
toJson() 和 API 输出需特别干预
$model->toJson() 默认调用 PHP 原生 json_encode，对 float 会丢失精度。即使获取器返回了 "199.99"，若底层字段类型是 float，仍可能被转成 199.98999999999998。稳妥做法是：
- 在获取器中强制返回字符串：
return number_format((float) $value, 2, '.', ''); - 若使用
$withAttr批量绑定，也需确保回调函数返回字符串 - 导出 Excel 等场景，需显式调用
$model->append(['amount_formatted'])->toArray()触发格式化
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
