Laravel 中对比 JSON 数据差异的实用方法-php教程-PHP中文网

Laravel 中对比 JSON 数据差异的实用方法

本文介绍在 laravel 应用中高效识别两个 json 对象（如历史快照与当前状态）之间字段级差异的技术方案，适用于审计日志、变更追踪等场景。

本文介绍在 laravel 应用中高效识别两个 json 对象（如历史快照与当前状态）之间字段级差异的技术方案，适用于审计日志、变更追踪等场景。

在 Laravel 开发中，常需对比模型变更前后的数据（例如记录编辑前后的状态），尤其当业务将结构化数据以 JSON 形式存入数据库字段时（如 json 类型字段或序列化配置）。上述问题中，用户存储了 "old"（原始状态）和 "attributes"（新状态）两个嵌套对象，目标是精准提取所有值不一致的键及其前后值。

✅ 推荐实现方式：深度遍历 + 严格比较（===）

PHP 原生 array_diff() 不适用于关联数组的键值对差异检测（它仅比较值，且会重排索引），而 Laravel 未内置 JSON 差异工具。因此，最可靠、可控的方式是手动遍历键并进行全等比较（===），确保类型与值均一致：

dmap-jsapi-skill

DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。

下载

// 假设 $json 是从数据库读取的 JSON 字符串
$json = '{"old": {...}, "attributes": {...}}';
$data = json_decode($json, true);

$differences = [];

// 确保两个子数组存在且为数组
if (isset($data['old']) && isset($data['attributes']) && is_array($data['old']) && is_array($data['attributes'])) {
    // 遍历 old 的所有键（覆盖全量字段）
    foreach ($data['old'] as $key => $oldValue) {
        $newValue = $data['attributes'][$key] ?? null;

        // 使用全等比较：避免 '1' == 1 误判，同时处理 null/0/false 等边界情况
        if ($oldValue !== $newValue) {
            $differences[$key] = [
                'old' => $oldValue,
                'new' => $newValue,
            ];
        }
    }

    // 可选：补充 attributes 中存在但 old 中不存在的字段（新增字段）
    foreach ($data['attributes'] as $key => $newValue) {
        if (!array_key_exists($key, $data['old'])) {
            $differences[$key] = [
                'old' => null,
                'new' => $newValue,
            ];
        }
    }
}

// 结果示例（与问题中一致）：
// [
//   'updated_at' => ['old' => '2022-04-14T09:07:41Z', 'new' => '2022-04-14T09:09:08Z'],
//   'dispatcher_id' => ['old' => 3, 'new' => 4],
//   'selected_products' => ['old' => '[1,3]', 'new' => '[1,3,2]'],
//   'selected_documents' => ['old' => '[5]', 'new' => '[5,6,4]']
// ]

⚠️ 注意事项与最佳实践

JSON 解析安全：始终使用 json_decode($json, true) 并检查返回值是否为 null（解析失败时），建议包裹在 try-catch 或添加 json_last_error() 校验。
数组 vs 字符串数组：如 selected_products 字段实际存储的是 JSON 数组字符串（"[1,3]"），而非原生数组，对比时需注意——若需语义级差异（如忽略顺序），应先 json_decode() 再排序比较；但多数审计场景只需字面量差异，保持字符串原样对比更直观、高效。

Laravel 模型集成建议：可封装为 Eloquent 访问器或独立服务类。例如，在模型中添加方法：

public function getDifferencesAttribute(): array
{
    $json = $this->getRawOriginal('json_data') ?? '{}';
    $data = json_decode($json, true) ?: [];
    return $this->computeJsonDifferences($data['old'] ?? [], $data['attributes'] ?? []);
}