ThinkPHP不提供开箱即用的数据变更审计功能，必须显式查询原始快照（如find($id)）与新数据比对，统一序列化（如json_encode+JSON_SORT_KEYS）、过滤无关字段、归一化类型后才可生成可靠diff。
ThinkPHP 本身不提供开箱即用的数据变更审计功能，getChangedData() 只能拿到「本次 save 操作中被显式赋值且与原始值不同的字段」，无法覆盖软删除、时间戳自动写入、JSON 字段解析差异等场景。真要记录可靠 diff，必须自己控制取值时机、统一序列化方式、过滤无关字段。
ThinkPHP 中怎么安全提取新旧值做对比
关键不是“怎么比”，而是“从哪取值”——getOriginal() 和 getData() 返回的内容类型可能不一致，直接 === 会出错。
-
getOriginal()返回数据库原始读取值（如"1"字符串、"2024-05-20 14:30:00"字符串） -
getData()返回模型当前属性值（如整数1、Carbon实例） - JSON 字段在
getData()中是数组，在toArray()中又可能变回字符串 - 别用
toArray()做 diff，它会混入create_time等自动写入字段，且对 null/'' 处理不一致
实操建议：统一用 json_encode($val, JSON_UNESCAPED_UNICODE | JSON_SORT_KEYS) 序列化后再比较，避免类型、顺序、编码干扰。
为什么 getChangedData() 不足以支撑审计日志
getChangedData() 是个便利方法，但它只反映「模型层感知到的变更」，不是「数据库实际变更」。
立即学习“PHP免费学习笔记（深入）”；
- 它不包含未被赋值但数据库已存在的字段（比如你没传
status，但数据库里 status 是 0，它不会出现在 changed 数组里） - 软删除字段
delete_time为null时，getChangedData()不触发，但业务上这是关键状态变更 - 关联字段（如
category_id）若通过with()加载了关联模型，getChangedData()完全不感知 - 时间字段自动更新（
update_time）会被模型自动重写，但你不希望它出现在业务 diff 里
所以审计日志必须基于「查询出的旧快照」和「save 前的新数据」做显式比对，不能依赖模型内部状态。
如何用 sebastian/diff 输出可读的字段级变更文本
sebastian/diff 专为文本设计，不适合直接比 PHP 数组。但你可以把字段 diff 转成多行文本再喂给它：
- 先用
array_diff_assoc()或手动循环提取变更字段，生成类似"title: '旧标题' → '新标题'\nstatus: 0 → 1"的字符串 - 确保每行末尾有换行符（
\n），否则UnifiedDiffOutputBuilder会把整段当一行处理 - 构造两个字符串：
$oldText = implode("\n", $oldLines); $newText = implode("\n", $newLines); - 调用
$differ->diff($oldText, $newText)，输出就是带 +/- 标记的结构化变更说明
注意：不要传空数组或 null 给 diff()，会抛异常；中文字段名没问题，但需确保整个流程使用 UTF-8 编码。
JSON 字段和枚举字段怎么避免误判
JSON 字段内容顺序、空白、null/'' 差异极易导致 false positive；枚举字段常有 getStatusLabelAttr 这类访问器，但审计要看原始值。
- JSON 字段（如
extra）：一律用json_encode($model->extra, JSON_UNESCAPED_UNICODE | JSON_SORT_KEYS)，加JSON_SORT_KEYS防止键顺序不同被判为变更 - 枚举字段（如
status）：比对时只用$model->status，绝不用$model->status_label—— 后者是展示逻辑，不是数据事实 - 时间字段（如
publish_time）：统一转为时间戳strtotime($model->publish_time)再比，避开字符串格式、Carbon 对象、时区等干扰 - 布尔字段（tinyint(1)）：显式 cast 为 int 或 string，例如
(int)$model->is_active，避免 PDO 返回字符串引发严格比较失败
真正难的不是写出 diff 逻辑，而是让每一处字段都按业务语义归一化——同一字段在旧快照和新数据里，必须走完全相同的转换路径，否则永远有漏网之鱼。
