展开菜单
首页 精品内容 本月促销 装机必备 Windows PDF教程 macOS软件 IOS软件 Android AI 专题
全部分类

当前位置:

首页 > 编程开发 > Laravel如何做模型属性变更记录差异日志_Laravel对比新旧值存入审计表【详解】

Laravel如何做模型属性变更记录差异日志_Laravel对比新旧值存入审计表【详解】

在Laravel中准确记录模型属性变更,需使用$model->getOriginal()获取数据库原始值,并确保模型已加载且原始快照未被修改。新建模型需判断exists状态,JSON字段需解码后比对。建议采用白名单逐字段对比,并标准化JSON存储以避免格式差异。审计日志宜使用异步队列写入,避免影响主流程性能。

本文目录
    在 Lara vel 模型保存前获取旧值和新值,唯一可靠方式是使用 $model->getOriginal() 获取数据库原始值,但需确保模型已从数据库加载且未被 refresh 或手动修改原始快照;新建模型时 exists === false,JSON 字段需 json_decode() 后比对;建议用白名单逐字段对比并标准化 JSON 存储。

    Lara vel如何做模型属性变更记录差异日志_Lara vel对比新旧值存入审计表【详解】

    如何在 Lara vel 模型保存前拿到旧值和新值

    想在 Lara vel 的 updating 或 sa ving 事件里准确捕获数据变化?$model->getOriginal() 几乎是唯一可靠的途径。但这里有个关键前提:它只在模型已从数据库加载(换句话说,不是新建记录)且其内部原始快照未被 refresh() 或手动修改过时,给出的结果才是准确的。

    一个常见的误区是直接拿 $model->getAttributes() 来做对比,结果发现所谓的“旧值”其实是上一次 set 操作后的值,并非数据库里的真实状态。这个坑在批量更新或者中间件偷偷修改了属性后,尤其隐蔽。

    • $model->isDirty() 可以用来判断哪些字段发生了变动,但它不提供具体的旧值,需要配合 getOriginal('field') 来使用。
    • 如果模型是通过 findOrNew() 或构造函数新建的,getOriginal() 会返回一个空数组。这时候,先判断 exists === false 再决定是否跳过审计逻辑,是个稳妥的做法。
    • 对于 JSON 或序列化字段(比如定义了 $casts = ['meta' => 'array']),getOriginal() 返回的是原始的 JSON 字符串。必须先用 json_decode() 处理,再进行比对,否则浅层比较永远会认为它们不相等。

    Lara vel 用 diffAttributes() 做差异提取容易漏字段

    diffAttributes() 这个方法看起来方便,但它仅仅是比较当前属性数组和原始属性数组的键值对。以下几种情况它可能处理不了:

    • 数据库默认值字段:假设 status 字段默认是 'draft'。插入记录时如果没设置值,getOriginal() 里就不会有这个键,diff 就会忽略它。但从业务角度看,你可能需要记录这个“从无到有”的默认值变化。
    • 属性被手动移除:使用 fill() 批量赋值后,如果在调用 sa ve() 前又执行了 unset($model->xxx),那么这个字段就不会出现在 getAttributes() 里,但 getOriginal() 里还有。这时 diff 会误以为该字段被“删除”了。
    • 软删除的语义:当软删除字段 deleted_at 被 delete() 方法触发时,getOriginal('deleted_at') 是 null,新值是时间戳,diff 能正确捕获。但问题来了:当模型被 restore() 恢复时,deleted_at 又从时间戳变回了 null。此时 diff 显示的是“从时间戳 → null”,而业务语义其实是“恢复记录”,并非简单的“清空字段”。

    因此,更建议的做法是自己编写一个最小化的差异对比工具函数。显式声明一个需要审计的字段白名单,然后逐个检查 isset($original[$key]) 和 array_key_exists($key, $original),避免过度依赖框架的自动推导逻辑。

    审计日志存入数据库时,json 字段 vs text 字段的实际影响

    选择 MySQL 存储差异日志时,别为了省事把所有内容都塞进 text 字段。虽然 json 类型支持索引和丰富的查询函数(比如 JSON_CONTAINS),但在 Lara vel 8+ 版本中,默认将数组转换为 json 字段时,会进行强制格式化(比如添加空格、对键进行排序)。这会导致两次完全相同的变更,最终生成的 JSON 字符串却不一致,无法直接用 = 操作符来查询重复的日志。

    • 如果决定用 json 字段存储 changes,务必在数据入库前,使用 json_encode($diff, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) 进行标准化处理,并且不要添加 JSON_PRETTY_PRINT 选项。
    • PostgreSQL 的 jsonb 类型没有这个格式化问题,但要注意,Lara vel 的 whereJsonContains() 方法在 PostgreSQL 上实际执行的是表达式函数,可能无法有效利用索引。如果对查询性能有较高要求,还是考虑将变更拆分成单独的字段(例如 changed_field, old_value, new_value)更靠谱。
    • 审计表的主键不建议使用自增 ID,改用 ULID 或 UUID 是更好的选择。这可以避免在高并发场景下,尤其是配合队列异步写入日志时,日志的记录顺序与实际事件发生顺序产生错乱。

    监听 sa ving 事件写审计日志,为什么有时没生效

    这个问题最常踩的坑是:在 AppServiceProvider::boot() 方法里使用类似 User::sa ving(...) 的语法绑定事件。如果模型类还没有被自动加载,Lara vel 既不会报错,也不会触发事件——因为事件绑定发生在类定义之前。

    • 正确的做法有两种:一是在模型类内部使用 static::sa ving() 方法注册事件;二是在 EventServiceProvider 的 $listen 属性数组中配置,例如 'eloquent.sa ving: App\Listeners\LogModelChange'。
    • 如果审计逻辑中需要执行其他 Eloquent 操作(比如查询关联的用户姓名),务必小心不要在事务中嵌套事务,否则可能引发死锁。可以用 DB::transactionLevel() === 0 来判断当前是否已在事务中。
    • 绝对不要在事件监听器里抛出 (throw) 异常,这会导致整个模型保存操作失败。审计逻辑失败时,应该静默地将错误记录到专用的日志文件(如 storage/logs/audit-fail.log),确保不影响主业务流程。

    说到底,实现审计日志功能,真正的挑战从来不是“如何记录”,而是如何确保“每次变更都记录、只记录一次、并且不拖慢主请求的响应速度”。异步队列处理、延迟批量写入、配合失败重试机制,这才是生产环境下的标准配置。同步写入日志,通常只适合在开发阶段做快速验证。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 laravel
    相关文章 更多
    精品专题 更多
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    macOS软件

    正软商城macOS软件专区,精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具,提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。

    IOS软件

    正软商城iOS软件专区,精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用,提供功能介绍、适用设备、系统要求和正版获取方式等信息。

    AI

    正软商城AI软件专区,汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具,提供功能介绍、适用平台、收费方式及正版购买信息。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    立刻MV 网页版
    立刻MV 网页版

    立刻MV 面向音乐人、内容创作者和品牌团队,帮助用户低成本完成歌曲 MV、歌词视频、AI 分镜、图生视频与最终合成。

    蛙蛙写作 网页版
    蛙蛙写作 网页版

    蛙蛙写作 AI 创作工具,覆盖小说、剧本、文案,一键生成文稿,打通文字转视频全流程,高效解决创作难题。

    超级简历WonderCV 网页版
    超级简历WonderCV 网页版

    超级简历WonderCV是面向应届生和AI小白的智能求职平台,覆盖简历、面试与职业规划。

    音述AI 网页版
    音述AI 网页版

    音述AI,是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区。

    AionClaw macOS版
    AionClaw macOS版

    AionClaw 是可在桌面端运行的任务型 AI 助手,通过数字专家与技能市场组合办公、创作、数据和开发能力。

    Loomy macOS版
    Loomy macOS版

    Loomy 是科大讯飞推出的桌面 AI 助手,可通过对话、任务与工作目录协助处理办公、内容创作和资料整理。

    AirBuddy 3 macOS版
    AirBuddy 3 macOS版

    AirBuddy 3 是面向 macOS 的蓝牙外设增强工具,可集中查看 AirPods、Beats 与苹果设备电量,提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。

    AirServer macOS版
    AirServer macOS版

    AirServer macOS版可把 Mac 转换为无线投屏接收端,通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面,并支持多设备同时连接、高清镜像及会话录制,适合家庭娱乐、课堂教学、会议演示和应用展示。

    AnyDesk macOS版
    AnyDesk macOS版

    AnyDesk macOS版是一款适用于远程办公、设备维护和客户支持的远程桌面工具,可连接并操作异地计算机,支持文件传输、无人值守访问、会话权限控制及跨平台协作。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。

    讯飞绘文 网页版
    讯飞绘文 网页版

    讯飞绘文网页版是科大讯飞推出的AI图文创作与内容运营工具,覆盖热点选题、文章生成、稿件校对、智能配图、排版发布和数据复盘等环节,适合自媒体创作者及内容团队在线使用。

    Maya(Autodesk Maya) Windows版
    Maya(Autodesk Maya) Windows版

    Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件,集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体,

    Aperty Windows版
    Aperty Windows版

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    立刻MV 网页版
    立刻MV 网页版

    立刻MV 面向音乐人、内容创作者和品牌团队,帮助用户低成本完成歌曲 MV、歌词视频、AI 分镜、图生视频与最终合成。

    蛙蛙写作 网页版
    蛙蛙写作 网页版

    蛙蛙写作 AI 创作工具,覆盖小说、剧本、文案,一键生成文稿,打通文字转视频全流程,高效解决创作难题。

    超级简历WonderCV 网页版
    超级简历WonderCV 网页版

    超级简历WonderCV是面向应届生和AI小白的智能求职平台,覆盖简历、面试与职业规划。

    音述AI 网页版
    音述AI 网页版

    音述AI,是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区。

    AionClaw Windows版
    AionClaw Windows版

    AionClaw 是可在桌面端运行的任务型 AI 助手,通过数字专家与技能市场组合办公、创作、数据和开发能力。

    Loomy Windows版
    Loomy Windows版

    Loomy 是科大讯飞推出的桌面 AI 助手,可通过对话、任务与工作目录协助处理办公、内容创作和资料整理。