Eloquent实现属性级领域事件与状态溯源需重写setAttribute逻辑并手动追踪变更,而非依赖Laravel原生模型事件;关键在于深拷贝原始状态、逐属性比对、生成可序列化事件对象,并通过版本化事件流重放重建状态。

PHP 里用 Eloquent 实现属性级领域事件(Attribute Domain Event)和状态溯源(Event Sourcing),不是 Laravel 原生支持的功能——它需要你主动拦截属性变更、生成事件、持久化事件流,并用事件重放重建状态。直接套用 getAttribute/setAttribute 或监听 updating 事件远远不够,因为那些只覆盖“整行更新”,无法精确捕获「某个属性从 A 变为 B」这一事实。
怎么让 Eloquent 感知单个属性的变更并触发领域事件
关键不是监听模型事件,而是重写属性赋值逻辑,用访问器+修改器+手动标记结合的方式实现细粒度追踪。Laravel 不提供 $model->originalAttributes 的属性级快照,所以得自己存一份:
- 在模型构造后或
booted()中,用$this->syncOriginal()确保原始值就位,再手动深拷贝一份$this->originalState = $this->getAttributes() - 重写
setAttribute($key, $value):先比对$this->originalState[$key] !== $value,若不同则记录变更(如$this->recordedEvents[] = new AttributeChanged($key, $this->originalState[$key], $value)) - 不要依赖
dirty()—— 它只反映是否被 set 过,不反映是否真变了;也不要用isDirty($key),它底层仍基于$this->original,而这个数组不会随中间 set 自动刷新
为什么不能直接用 Laravel 的 Model Events(saving/updating)做事件溯源
因为这些事件发生在 SQL 构建阶段,此时你只能拿到“最终值”,拿不到变更路径。比如用户连续改了两次邮箱:alice@example.com → bob@example.com → charlie@example.com,updating 只会触发一次,且 $model->getOriginal('email') 是初始值,不是上一次值。
-
saving时$model->wasChanged('email')返回 true,但你不知道它从哪来、经过几次中间态 - 事件溯源要求每个原子变更都独立可序列化、可重放,而 Laravel 默认模型生命周期不保存中间事件对象,只留最终 DB 行
- 如果你把事件写进数据库,必须确保事务包裹:先 insert event,再 update model,否则状态与事件不一致
如何存储和重放属性变更事件(最小可行 Event Stream)
别一上来就搞复杂事件总线或 Kafka。先用一张 events 表存最简结构:aggregate_type(如 'user')、aggregate_id、event_name(如 'EmailChanged')、payload(JSON,含 from 和 to)、version(递增整数)。
立即学习“PHP免费学习笔记(深入)”;
- 重放时按
versionASC 查询所有该聚合的事件,逐条调用对应 handler(如EmailChanged::applyTo($user)),而不是靠 DB 字段回填 - 模型的
$casts和get*访问器必须失效——状态完全由事件流计算得出,DB 字段仅作快照(snapshot)可选优化,不可信 - 别在
__construct()里自动重放事件:会导致 new User() 就查库,破坏无状态构造;应显式调用User::reconstitute($id)
AttributeChanged 事件类该怎么设计才便于测试和扩展
它不是 Laravel 的 Event,不该继承 Illuminate\Foundation\Events\Dispatchable——那是为广播/队列准备的,而溯源事件是领域事实,要能序列化、版本兼容、带上下文。
- 字段最少包含:
aggregateType、aggregateId、attribute、oldValue、newValue、occurredAt(CarbonImmutable) - 加
public function applyTo($model)方法,让重放逻辑内聚:例如$model->attributes[$this->attribute] = $this->newValue,而非散落在 service 层 - 避免在事件里引用具体模型类或 Eloquent 方法——这会让事件无法跨语言重放;
oldValue/newValue必须是纯数组/标量/DateTimeInterface
真正难的不是写几个 event 类,而是守住边界:什么时候该用 DB 字段直读(快照),什么时候必须重放(强一致性);以及怎么让团队不绕过事件直接 $user->email = ...。没有框架能替你 enforce 这一点,只能靠构造函数私有化 + 工厂方法 + 静态分析约束。



















