
本文旨在阐明在 Laravel 中更新现有模型数据时,如何有效地禁用 `updated_at` 时间戳的自动更新。我们将深入探讨两种常用的方法,分析其背后的原理,并提供最佳实践建议,确保数据操作的准确性和可控性。
在 Laravel 开发中,模型的时间戳功能(created_at 和 updated_at)极大地简化了数据的创建和更新追踪。然而,在某些场景下,我们可能需要更新模型数据,但又不想修改 updated_at 时间戳。本文将详细介绍如何在 Laravel 中实现这一目标。
两种实现方式对比
通常,开发者会尝试以下两种方式来禁用时间戳更新:
方法 1:
$manual_ticket->status = "Queued"; $manual_ticket->initiator_id = null; $manual_ticket->save(['timestamps' => false]);
方法 2:
$manual_ticket->status = "Queued"; $manual_ticket->initiator_id = null; $manual_ticket->timestamps = false; $manual_ticket->save();
初看之下,这两种方法似乎都能达到禁用时间戳的目的,但实际上,只有第二种方法才能正确工作。
深入分析:save() 方法的内部机制
要理解这两种方法的差异,我们需要深入了解 Laravel 模型 save() 方法的内部实现。
当调用模型的 save() 方法时,Laravel 会进一步调用 finishSave() 方法。finishSave() 方法主要负责处理事件触发和时间戳更新。然而,finishSave() 方法只会接受 touch 作为数组键,不会处理任何其他传递给 save() 方法的数组键。因此,在第一种方法中,[‘timestamps’ => false] 实际上被忽略了,时间戳仍然会被更新。
另一方面,第二种方法通过直接设置模型的 $timestamps 属性为 false 来禁用时间戳更新。这样做会直接影响 save() 方法的行为,阻止其更新时间戳。
正确禁用时间戳更新的最佳实践
推荐使用第二种方法,即在保存模型之前,将模型的 $timestamps 属性设置为 false:
$manual_ticket->status = "Queued"; $manual_ticket->initiator_id = null; $manual_ticket->timestamps = false; $manual_ticket->save(); // 恢复时间戳功能 (可选) $manual_ticket->timestamps = true;
在保存模型后,可以选择将 $timestamps 属性恢复为 true,以便后续操作可以继续使用时间戳功能。
使用 saveQuietly() 方法
Laravel 还提供了一个 saveQuietly() 方法,它可以保存模型而不触发任何模型事件。虽然 saveQuietly() 方法本身并不直接禁用时间戳更新,但它可以作为一种避免触发 updating 和 updated 事件的手段,这些事件可能会间接导致时间戳更新。
$manual_ticket->status = "Queued"; $manual_ticket->initiator_id = null; $manual_ticket->saveQuietly();
需要注意的是,saveQuietly() 方法不会检查模型的 $timestamps 属性。因此,如果启用了时间戳,saveQuietly() 仍然会更新 updated_at 时间戳。 如果需要同时禁用时间戳更新和避免触发模型事件,则需要结合使用 $timestamps = false 和 saveQuietly()。
注意事项和总结
- 明确需求: 在禁用时间戳更新之前,请仔细考虑是否真正需要这样做。时间戳在很多情况下对于数据追踪和审计非常有用。
- 版本兼容性: 本文基于 Laravel 5.5 进行分析,但相关原理在其他版本中也适用。建议查阅对应版本的官方文档以获取最准确的信息。
- 代码可读性: 在代码中添加注释,说明为什么禁用时间戳更新,可以提高代码的可读性和可维护性。
总而言之,通过直接设置模型的 $timestamps 属性为 false,我们可以有效地禁用 Laravel 中模型的时间戳自动更新。理解 save() 方法的内部机制,并结合 saveQuietly() 方法,可以帮助我们更灵活地控制模型的保存行为。
以上就是Laravel:更新模型数据时禁用时间戳自动更新的详细内容,更多请关注php中文网其它相关文章!


