ThinkPHP中应在查询模型后立即调用$model->getOriginal()获取数据库原始值,而非getData();该方法仅对find()等加载的实例有效,返回未经读取器处理的原始数据,需注意字段类型差异并统一格式后再严格对比。

ThinkPHP模型更新前如何获取原始数据
直接调用 $model->data 或 $model->getData() 拿到的是当前已赋值的新数据,不是数据库里原来的值。想比差异,必须在读取后、修改前就存一份快照。
常见错误是:先 $model->save($data) 再去查旧数据,这时事务还没提交,或者已经覆盖,根本拿不到原始状态。
- 正确做法是在查询模型实例后立刻调用
$model->getOriginal()—— 这是 ThinkPHP 6/7 提供的原生方法,返回初始化时从数据库加载的原始字段值 - 如果用了
withAttr或读取器(accessor),getOriginal()返回的是未处理的原始值(比如数据库存的是 0/1,getOriginal()就是 0/1;而getData()可能已转成 false/true) - 注意:只有通过
find()/findOrFail()等方式加载的模型实例才有原始值;用new Model()创建的空模型,getOriginal()返回空数组
对比新旧值并生成差异标记的实用写法
ThinkPHP 本身不提供“diff + 高亮”渲染逻辑,得自己封装。核心是遍历字段,判断是否变更,并标记类型(新增/修改/删除)。
示例场景:编辑用户资料页提交后,返回一个带 <ins></ins> / <del></del> 的 HTML 片段用于前端展示:
立即学习“PHP免费学习笔记(深入)”;
// 假设 $user 是已查出的模型实例,$postData 是表单提交的新数据
$original = $user->getOriginal();
$current = $user->save($postData) ? $user->getData() : $user->getData(); // save 后 getData 是新值
$diff = [];
foreach (array_keys($original) as $field) {
$old = $original[$field] ?? null;
$new = $current[$field] ?? null;
if ($old !== $new) {
$diff[$field] = [
'old' => $old,
'new' => $new,
'changed' => true
];
}
}
注意:=== 判断严格相等,避免字符串 "0" 和整数 0 被误判为相同;若需语义比较(如忽略空格、大小写),得单独处理。
字段类型影响对比结果的几个坑
数据库字段类型和 PHP 类型不一致时,=== 很容易漏掉变更。比如:
-
tinyint(1)在 MySQL 中常被当成布尔用,但 PDO 默认返回字符串"1"或"0",而你传入的$postData['status']可能是整数1—— 字符串"1"!== 整数1,会被识别为变更,但实际没变 -
datetime字段,数据库存"2024-05-20 14:30:00",模型自动转成Carbon实例,getOriginal()返回字符串,getData()返回对象 —— 直接比会恒为 true - JSON 字段(
json类型或text存 JSON 字符串),getOriginal()返回字符串,getData()可能已自动json_decode成数组 —— 类型不同导致无法比
解决办法:统一转成可比格式再对比。例如对时间字段用 $model->originTime->format('Y-m-d H:i:s'),对 JSON 字段用 json_encode($old, JSON_UNESCAPED_UNICODE) 和 json_encode($new, JSON_UNESCAPED_UNICODE)。
前端高亮渲染建议与性能注意点
别在控制器里拼 HTML 字符串返回给前端,应该只传结构化差异数据(如上面的 $diff 数组),让前端决定怎么渲染 —— 更灵活,也避免 XSS 风险。
如果确实要在后端生成高亮 HTML(比如导出 PDF 或邮件通知),注意:
- 对
$old和$new值必须做htmlspecialchars()转义,再包裹<del></del>/<ins></ins> - 不要对整个
$diff数组做json_encode后直接echo,ThinkPHP 默认开启 XSS 过滤,可能把<ins></ins>当作危险标签过滤掉;改用response()->raw()或设置 header - 大批量记录对比(比如审核 100 条订单)时,逐条调用
getOriginal()会触发多次查询(如果没开启延迟加载或缓存),应改用 Db 查询一次性拉出原始数据做关联比对
最易被忽略的一点:软删除字段(delete_time)变更通常不纳入业务差异展示,但默认会被 getOriginal() 包含 —— 记得在遍历时 unset 或白名单过滤业务字段。


















