PHP数据变更审计：模型Diff记录教程

本文深入剖析了在ThinkPHP框架中实现可靠数据变更审计的核心难点与实战方案，指出仅依赖getChangedData()无法满足真实业务场景下的审计需求，必须通过显式获取数据库原始快照与保存前的新数据、统一序列化（如json_encode+JSON_SORT_KEYS）、严格归一化字段类型（时间戳、JSON、枚举、布尔等）并过滤无关字段，才能生成准确、可读、可追溯的字段级diff；同时详解了如何借助sebastian/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() 是个便利方法，但它只反映「模型层感知到的变更」，不是「数据库实际变更」。

• 它不包含未被赋值但数据库已存在的字段（比如你没传 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 逻辑，而是让每一处字段都按业务语义归一化——同一字段在旧快照和新数据里，必须走完全相同的转换路径，否则永远有漏网之鱼。

好了，本文到此结束，带大家了解了《PHP数据变更审计：模型Diff记录教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！