Laravel中获取Eloquent属性变更前后值最可靠方式是使用getOriginal('field')和getAttribute('field'),需确保模型已从数据库加载;推荐在updating事件中结合isDirty()检测字段变化并处理逻辑。

Laravel 没有内置的 Eloquent 属性变更事件(比如 “name 从 'A' 变成 'B'” 这种细粒度通知),直接监听 saved 或 updated 无法知道哪个字段变了、变前变后值是多少。
怎么拿到变更前后的属性值
Eloquent 的 $model->getOriginal('field') 和 $model->getAttribute('field') 是最可靠的方式——前者返回数据库原始值(即上次保存后的快照),后者返回当前内存中的值。注意:必须在模型已从数据库加载(或已 fresh())的前提下使用,新建模型($model->exists === false)时 getOriginal() 返回 null。
常见误用场景:
- 在
creating或created事件里调getOriginal()→ 总是null,因为还没入库 - 在控制器里改完属性就直接
save(),没先fresh()或没确保模型是从 DB 查出来的 →getOriginal()可能不是你期望的“上一次数据库值”
在 updated/saving 事件里安全检测字段变化
推荐在 saving 或 updating 事件中做判断,此时模型已加载原始数据,且变更尚未写入数据库,可中断流程或打日志。例如:
protected static function booted()
{
static::updating(function ($model) {
if ($model->isDirty('status') && $model->getOriginal('status') === 'pending' && $model->status === 'approved') {
// 触发审批通过逻辑
dispatch(new ApproveNotificationJob($model));
}
});
}
关键点:
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
- 用
isDirty('field')判断是否被修改,比手动比较更健壮(它会跳过未变更字段、处理 null/empty 差异) -
updating在 SQL 执行前触发,适合校验或补充逻辑;updated在事务提交后,适合发通知但不能改模型状态 - 避免在
updated里再调save(),容易引发递归或事务异常
需要监听多个字段或复杂条件时怎么办
别堆砌嵌套 if (isDirty()) {...}。把检测逻辑抽成方法,配合 getDirty() 一次性获取所有变更字段及其新值:
public function getChangedFields(): array
{
return array_filter($this->getDirty(), function ($value, $key) {
return $this->isDirty($key) && $this->getOriginal($key) !== $value;
}, ARRAY_FILTER_USE_BOTH);
}
这样你可以:
- 遍历
getChangedFields()做统一审计日志(记录谁、何时、改了哪些字段、从什么到什么) - 结合
$this->wasChanged('field')(仅适用于updated事件)补全旧值,但注意它不支持批量字段判断 - 对敏感字段(如
email、role)单独加钩子,其他走通用日志
真正难的不是“怎么监听”,而是厘清变更发生的上下文:是用户表单提交?API patch?还是后台命令批量更新?不同入口的数据来源和可信度不同,getOriginal() 的有效性也依赖于模型是否真实代表 DB 状态。别假设“只要用了 Eloquent 就自动有快照”,该 refresh() 的地方别省,该加事务锁的别漏。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










