
本文详解如何在 php 中深度比对两个结构相同的 json 对象(或其解码后的数组/对象),自动识别所有键值变化,精确返回包含 key_name、old_value 和 new_value 的差异列表,适用于配置审计、数据变更追踪等场景。
本文详解如何在 php 中深度比对两个结构相同的 json 对象(或其解码后的数组/对象),自动识别所有键值变化,精确返回包含 key_name、old_value 和 new_value 的差异列表,适用于配置审计、数据变更追踪等场景。
在实际开发中,我们常需对比前后两次获取的 JSON 数据(如用户资料、权限配置、订单状态),快速定位具体哪些字段发生了变更。但直接使用 == 或 === 比较 JSON 字符串易受格式、空格、键序影响;而简单解码后用 != 比较对象属性,在嵌套或含数组时又可能因引用不一致导致误判。本文聚焦单层对象数组的精准差异提取——即输入为两个长度均为 1 的 JSON 数组(各含一个对象),目标是逐字段比对,仅返回值不同的键及其新旧值。
以下是一个健壮、可读性强且生产可用的 PHP 实现:
<?php // 示例数据:注意此处直接使用关联数组更清晰,避免冗余 json_encode/json_decode
$object1 = ["acc_number" => 1001, "acc_name" => "admin", "acc_loc" => "headquarters"];
$object2 = ["acc_number" => 1001, "acc_name" => "New Admin", "acc_loc" => "branch"];
// ✅ 安全解码(若原始数据为 JSON 字符串,请先验证并解码)
// $object1 = json_decode($jsonStr1, true) ?: [];
// $object2 = json_decode($jsonStr2, true) ?: [];
$differences = [];
// 遍历第一个对象的所有键(确保覆盖所有可能字段)
foreach ($object1 as $key => $oldValue) {
// 检查 object2 是否存在该键,且值不相等(使用 == 支持类型宽松比较,如 "1" == 1)
if (!array_key_exists($key, $object2) || $object2[$key] != $oldValue) {
$differences[] = [
'key_name' => $key,
'old_value' => $oldValue,
'new_value' => $object2[$key] ?? null // 若 key 不存在则设为 null,便于调试
];
}
}
// 输出结果(JSON 格式化便于查看)
header('Content-Type: application/json; charset=utf-8');
echo json_encode($differences, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
?>
输出结果:
[
{
"key_name": "acc_name",
"old_value": "admin",
"new_value": "New Admin"
},
{
"key_name": "acc_loc",
"old_value": "headquarters",
"new_value": "branch"
}
]
✅ 关键设计说明:
- 不依赖 JSON 字符串比较:避免因空格、换行、键顺序不同导致的假阴性;
-
使用
array_key_exists()+!=组合:既检查键是否存在,又支持合理类型转换(如字符串"1"与整数1视为相等),兼顾灵活性与准确性; -
显式处理缺失键:若
$object2缺少某字段,仍能捕获并标记new_value为null,便于后续逻辑判断; - 零依赖、纯原生 PHP:无需额外扩展或 Composer 包,兼容 PHP 7.4+。
⚠️ 注意事项:
- 本方案默认假设两个对象具有完全一致的顶层键集合。如需支持“新增键”或“删除键”的完整 diff(类似 Unix
diff),应扩展逻辑,分别遍历$object1和$object2的键并取并集; - 若对象含深层嵌套(如
address.city)或数组(如"tags": ["a","b"]),需改用递归比较函数(例如自定义deepDiff($a, $b)),本文未展开以保持聚焦; - 生产环境务必添加
json_last_error()校验,防止无效 JSON 导致静默失败。
通过此方法,你不仅能精准提取差异,还能轻松集成到 API 响应、日志记录或前端变更预览模块中,显著提升数据一致性保障能力。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











