PHP实现数据变更审计_记录模型变更的Diff差异【教程】-php教程-PHP中文网

thinkphp不提供开箱即用的数据变更审计功能，必须显式查询原始快照（如find($id)）与新数据比对，统一序列化（如json_encode+json_sort_keys）、过滤无关字段、归一化类型后才可生成可靠diff。

php实现数据变更审计_记录模型变更的diff差异【教程】

ThinkPHP 本身不提供开箱即用的数据变更审计功能，getChangedData() 只能拿到「本次 save 操作中被显式赋值且与原始值不同的字段」，无法覆盖软删除、时间戳自动写入、JSON 字段解析差异等场景。真要记录可靠 diff，必须自己控制取值时机、统一序列化方式、过滤无关字段。

关键不是“怎么比”，而是“从哪取值”——getOriginal() 和 getData() 返回的内容类型可能不一致，直接 === 会出错。

实操建议：统一用 json_encode($val, JSON_UNESCAPED_UNICODE | JSON_SORT_KEYS) 序列化后再比较，避免类型、顺序、编码干扰。

getChangedData() 是个便利方法，但它只反映「模型层感知到的变更」，不是「数据库实际变更」。

所以审计日志必须基于「查询出的旧快照」和「save 前的新数据」做显式比对，不能依赖模型内部状态。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

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 字段内容顺序、空白、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 返回字符串引发严格比较失败