本文探讨了在 laravel/lumen 应用中，当模型在事件派发前被修改并保存后，如何在事件监听器中访问其原始状态的问题。通过详细的代码示例，我们展示了由于 save() 操作导致 getoriginal() 失效的原因，并提供了一种简单有效的解决方案：在模型修改前捕获所需原始数据，并将其作为附加参数传递给事件，确保监听器能够获取到正确的历史数据。
理解模型状态的瞬时性
在 Laravel/Lumen 框架中，使用事件（Events）和监听器（Listeners）模式是扩展模型功能、保持代码整洁的常见做法。然而，当模型在事件派发之前经历修改并保存操作时，监听器可能会面临无法访问模型原始状态的挑战。
考虑一个模型具有 reset 方法，用于将其某些属性设置为 null 并保存：
// 原始的 reset 方法
public function reset()
{
$this->association_id = null;
$this->associated_at = null;
$this->save(); // 模型状态在此处被持久化
}为了在 reset 操作后添加新的功能，我们引入了事件派发：
// 引入事件派发后的 reset 方法
public function reset()
{
$this->association_id = null;
$this->associated_at = null;
$this->save(); // 此时模型已保存，其属性 association_id 已变为 null
event(new ResetEvent($this)); // 派发事件，传递的是更新后的模型实例
}对应的事件和监听器定义如下：
// ResetEvent 类
class ResetEvent
{
public $myModel;
public function __construct($myModel)
{
$this->myModel = $myModel;
}
}
// ResetListener 类
class ResetListener
{
public function handle(ResetEvent $event)
{
// 尝试获取 association_id
$associationId = $event->myModel->association_id; // 此时为 null
// 尝试获取原始 association_id
$originalAssociationId = $event->myModel->getOriginal('association_id'); // 此时也为 null
// ... 执行其他业务逻辑 ...
}
}核心挑战在于： 当 event(new ResetEvent($this)) 被调用时，$this 指向的模型实例已经通过 save() 方法更新并持久化到数据库。这意味着模型的 association_id 属性已经变为 null。更重要的是，getOriginal() 方法在 save() 调用后也会被重置，其记录的“原始”状态也变成了当前保存后的状态。因此，在监听器中无论是直接访问属性还是使用 getOriginal()，都无法获取到 reset 操作发生之前的 association_id 值。
解决方案：显式传递原始数据
解决此问题的最直接和有效的方法是，在模型属性被修改和保存 之前，显式地捕获监听器可能需要的原始值，并将其作为事件的额外参数传递。
以下是修改后的 reset 方法、ResetEvent 和 ResetListener：
// 修改后的 reset 方法
public function reset()
{
// 在修改和保存之前，捕获 association_id 的原始值
$lastAssociation = $this->association_id;
$this->association_id = null;
$this->associated_at = null;
$this->save(); // 模型状态在此处更新
// 将更新后的模型实例和捕获到的原始值一同传递给事件
event(new ResetEvent($this, $lastAssociation));
}// 修改后的 ResetEvent 类
class ResetEvent
{
public $myModel;
public $lastAssociationId; // 新增属性，用于存储原始 association_id
public function __construct($myModel, $lastAssociationId)
{
$this->myModel = $myModel;
$this->lastAssociationId = $lastAssociationId;
}
}// 修改后的 ResetListener 类
class ResetListener
{
public function handle(ResetEvent $event)
{
// 现在可以安全地访问原始的 association_id
$originalAssociationId = $event->lastAssociationId;
// 同时也可以访问更新后的模型状态
$currentAssociationId = $event->myModel->association_id; // 此时为 null
// ... 基于原始和当前数据执行业务逻辑 ...
echo "模型原始 association_id: " . $originalAssociationId . "\n";
echo "模型当前 association_id: " . $currentAssociationId . "\n";
}
}通过这种方式，$event->lastAssociationId 将始终包含 reset 方法执行前 association_id 的值，而 $event->myModel 则包含 reset 方法执行后（即 save() 之后）的模型最新状态。这使得监听器能够同时访问模型的历史和当前状态，满足了业务逻辑的需求。
注意事项与最佳实践
- 选择性传递: 只传递监听器真正需要的原始数据。避免将整个模型克隆或传递过多不必要的原始属性，这可能会增加内存消耗和事件对象的序列化/反序列化开销（尤其是在使用队列时）。
- 数据传输对象 (DTO): 如果需要传递的原始状态数据较为复杂或包含多个相关属性，可以考虑创建一个专门的 DTO（Data Transfer Object）来封装这些原始数据，而不是直接在事件中添加多个散列参数。这能提高代码的可读性和维护性。
-
事件命名与时机:
- 如果事件的语义是“即将发生”（例如 UserDeletingEvent），那么在模型修改或保存 之前 派发事件，此时传递的模型实例将是其原始状态。
- 如果事件的语义是“已发生”（例如 UserDeletedEvent 或本例的 ResetEvent），则通常在模型操作（如 save() 或 delete()） 之后 派发。在这种情况下，显式传递原始数据是获取历史状态的有效手段。
- 同步与异步: 本方案适用于同步和异步事件。对于异步事件，传递的原始数据会安全地序列化并传递给队列中的监听器，确保数据完整性。
总结
在 Laravel/Lumen 事件监听器中获取模型原始状态的关键在于理解模型生命周期和 save() 方法对 getOriginal() 的影响。当模型在事件派发前被修改并保存时，模型实例的状态会更新，getOriginal() 也会随之重置。通过在模型属性修改前显式捕获所需原始值，并将其作为附加参数传递给事件，我们可以确保监听器能够准确无误地访问模型的历史数据。这种方法简单、直接且高效，是处理此类场景的推荐实践。
