Laravel Eloquent 模型保存时禁止更新时间戳的正确方法

本文旨在阐明在 Laravel 5.5 中，如何正确地更新 Eloquent 模型而避免更新 `updated_at` 时间戳。我们将对比两种不同的实现方式，解释为何一种方式无效，并提供有效的解决方案，同时深入源码分析原因。

在 Laravel 开发中，我们经常需要更新数据库中的数据，但有时我们不希望更新 updated_at 时间戳。这通常发生在数据处理或迁移等场景。本文将深入探讨如何在 Laravel 5.5 中实现这一目标，并分析两种常见的实现方式的差异。

错误的尝试：save(['timestamps' => false])

一种常见的尝试是使用 save(['timestamps' => false]) 方法。以下是示例代码：

$manual_ticket->status = "Queued";
$manual_ticket->initiator_id = null;
$manual_ticket->save(['timestamps' => false]);

然而，这种方法在 Laravel 5.5 中并不能阻止 updated_at 时间戳的更新。这是因为 save() 方法在内部会调用 finishSave() 方法。finishSave() 方法只会接受 touch 作为数组键，而忽略其他键，因此传递 ['timestamps' => false] 不会产生任何效果。

正确的实现：$timestamps = false

正确的做法是在保存模型之前，将模型的 $timestamps 属性设置为 false。以下是示例代码：

$manual_ticket->status = "Queued";
$manual_ticket->initiator_id = null;
$manual_ticket->timestamps = false;
$manual_ticket->save();

通过将 $timestamps 属性设置为 false，Eloquent 模型在保存时将不会自动更新 created_at 和 updated_at 时间戳。

源码分析

知我AI

一款多端AI知识助理，通过一键生成播客/视频/文档/网页文章摘要、思维导图，提高个人知识获取效率；自动存储知识，通过与知识库聊天，提高知识利用效率。

101

查看详情

为了更好地理解其背后的原因，我们可以查看 Laravel 框架的源码。在 Illuminate\Database\Eloquent\Model 类的 save() 方法中，最终会调用 finishSave() 方法。finishSave() 方法的代码如下（简化版）：

protected function finishSave(array $options)
{
    if (isset($options['touch'])) {
        $this->touch();
    }

    return $this;
}

正如我们所见，finishSave() 方法只检查 $options 数组中是否存在 touch 键。如果存在，它会调用 touch() 方法来更新时间戳。否则，它会忽略 $options 数组中的其他键。

更高级的用法：saveQuietly()

除了上述方法外，Laravel 还提供了一个 saveQuietly() 方法，它可以保存模型而不触发任何模型事件。这在某些情况下非常有用，例如，当你想要在后台更新数据而不影响应用程序的其他部分时。

$manual_ticket->status = "Queued";
$manual_ticket->initiator_id = null;
$manual_ticket->saveQuietly();

saveQuietly() 方法同样会尊重 $timestamps = false 的设置。

注意事项

• 确保在保存模型之前设置 $timestamps = false。
• saveQuietly() 方法会跳过所有模型事件，包括 creating、created、updating、updated、saving 和 saved。
• 如果需要在多个地方使用此功能，可以考虑创建一个 trait，并在需要禁用时间戳的模型中使用它。

总结

在 Laravel 中，要禁止 Eloquent 模型在保存时更新时间戳，正确的做法是设置模型的 $timestamps 属性为 false。save(['timestamps' => false]) 方法无效，因为 finishSave() 方法会忽略除 touch 之外的所有选项。此外，saveQuietly() 方法提供了一种在不触发模型事件的情况下保存模型的替代方案。理解这些概念可以帮助你更好地控制 Eloquent 模型的行为，并编写更健壮的代码。

以上就是Laravel Eloquent 模型保存时禁止更新时间戳的正确方法的详细内容，更多请关注php中文网其它相关文章！