PHP怎么处理Eloquent Attribute Auditing属性审计_Laravel追踪字段变更历史【指南】-php教程-PHP中文网

直接监听 $casts 或 $fillable 无法审计字段变更，因为二者不介入属性赋值流程；审计需在 updating/saving 事件中手动比对，或使用 owen-it/laravel-auditing 并正确配置 Auditable trait、$auditInclude、audits() 关系及数据库迁移。

php怎么处理eloquent attribute auditing属性审计_laravel追踪字段变更历史【指南】

为什么直接监听 `$casts` 或 `$fillable` 无法审计字段变更

因为 Eloquent 的属性审计不是靠模型定义触发的，而是依赖对属性赋值前后的状态比对。Laravel 原生不提供字段级变更历史记录，$casts 只影响序列化行为，$fillable 仅控制批量赋值白名单——它们都不介入 setter 流程，也无法捕获“旧值 → 新值”的变化瞬间。

真正可行的路径只有两条：在 updating / saving 事件中手动比对，或借助第三方包（如 owen-it/laravel-auditing）封装好的生命周期钩子。

手动方案适合极简场景（比如只审计 1–2 个关键字段），但需自行处理 JSON 存储、关联模型 ID、时间戳、用户 ID 绑定
用 owen-it/laravel-auditing 时，必须在模型中显式启用 Auditable trait，并配置 $auditInclude 指定要追踪的字段，否则默认不审计任何属性
该包不会自动记录 created_at / updated_at 等时间字段，除非你把它加进 $auditInclude 数组里

`audited()` 和 `audits()` 关系搞反会导致查不到历史

audited() 是一个作用于模型实例的 accessor，返回当前模型是否已被标记为可审计（即是否用了 Auditable trait 且配置有效）；而 audits() 才是 Eloquent 关系方法，用于查询该模型实例产生的所有审计记录。

常见错误是写成 $user->audited()->get() —— 这会报错，因为 audited() 返回布尔值，不是关系对象。正确写法是：

$user->audits()->latest()->take(5)->get()

另外注意：audits() 默认加载的是 Audit 模型（来自包），它和你的业务模型无共享字段，不能直接调用 $audit->name。要读取变更前后的值，得通过 $audit->getOriginal('email') 和 $audit->getNewValue('email')。

btpanel phpsite 宝塔面板PHP网站

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

下载

审计数据存不进数据库？检查 `audit_driver` 和迁移是否到位

默认配置下，owen-it/laravel-auditing 使用 database 驱动，但它不会自动发布迁移文件。如果你跳过了 php artisan vendor:publish --provider="OwenIt\Auditing\AuditingServiceProvider" --tag="migrations"，或者执行迁移后没跑 php artisan migrate，audits 表根本不存在，所有审计日志都会静默丢弃，连异常都不会抛。

运行 php artisan config:clear 后再查 config('audit.driver')，确认值是 database 而非 null 或 redis
audits 表必须包含 old_values 和 new_values 两个 JSON 字段，类型必须是 json（MySQL 5.7+ / PostgreSQL）或 text（低版本 MySQL），否则 saveAudit() 会因 JSON 编码失败而终止
如果用 SQLite，需确保开启 JSON1 扩展，否则 getOriginal() 返回空数组

软删除模型的审计记录会被连带清除

当模型启用了 SoftDeletes，它的审计记录默认不继承软删除行为。也就是说，一旦执行 $post->delete()，posts 表里该行变成 deleted_at IS NOT NULL，但对应的 audits 表记录依然存在且可查——这看似合理，但容易造成误解：你以为删了文章就清掉了所有痕迹，其实审计日志还躺在那里。

更麻烦的是，如果你之后调用 $post->restore()，审计记录不会自动恢复关联（因为 auditable_id 和 auditable_type 没变），但 $post->audits 查询仍能命中——前提是 audits 表本身没被清理过。

若需同步清理，得手动监听 deleted 事件，在其中执行 Audit::where('auditable_id', $model->id)->where('auditable_type', get_class($model))->delete()
反过来，若想保留审计记录但不让软删除模型出现在 audits() 查询结果中，得重写 audits() 关系，加上 whereNull('auditable.deleted_at') 条件（需自定义关联方法）

审计不是快照备份，它只记录变更动作。哪怕字段值从 A → B → A，也会留下两条记录，中间没有去重逻辑——这点在做报表或回滚设计时特别容易踩空。