🚀 Laravel 软删除功能的删除时间戳管理与数据存档策略讲座

大家好！欢迎来到今天的 Laravel 技术讲座 🎤。今天我们要聊的是一个非常实用的功能——软删除（Soft Delete），以及如何优雅地管理删除时间戳和实现数据存档策略。如果你对硬删除（直接从数据库中移除数据）感到害怕，那么软删除就是你的救星 😌。

📝 什么是软删除？

在 Laravel 中，软删除是一种“假删除”的方式。它并不会真正从数据库中移除记录，而是通过设置一个时间戳字段（通常是 deleted_at）来标记该记录已被删除。这样，你可以在需要的时候轻松恢复数据，或者永久删除它们。

简单来说，软删除就像把文件移到了回收站 🗑️，而不是直接按下 Shift + Delete。

🔧 如何启用软删除？

要使用软删除功能，你需要在模型中引入 SoftDeletes 特性，并确保数据库表中有 deleted_at 字段。

1. 修改迁移文件

首先，在迁移文件中添加 deleted_at 字段：

use IlluminateDatabaseSchemaBlueprint;
use IlluminateSupportFacadesSchema;

Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->timestamps(); // 创建 created_at 和 updated_at 字段
    $table->softDeletes(); // 添加 deleted_at 字段
});

运行迁移命令后，你的表结构将包含以下字段：

Field	Type	Description
id	int	主键
name	varchar	用户名
created_at	timestamp	创建时间
updated_at	timestamp	更新时间
deleted_at	timestamp	删除时间（软删除时的时间戳）

2. 在模型中启用软删除

接下来，在模型中引入 SoftDeletes 特性：

namespace AppModels;

use IlluminateDatabaseEloquentModel;
use IlluminateDatabaseEloquentSoftDeletes;

class User extends Model
{
    use SoftDeletes; // 启用软删除

    protected $dates = ['deleted_at']; // 确保 deleted_at 被视为日期时间类型
}

现在，当你调用 $user->delete() 时，Laravel 不会真正删除这条记录，而是将 deleted_at 设置为当前时间。

🕰️ 删除时间戳管理

软删除的核心是 deleted_at 时间戳。让我们看看如何管理和操作这个字段。

1. 查询未删除的数据

默认情况下，查询结果只会返回 deleted_at 为空的记录。例如：

$users = User::all(); // 只返回未删除的用户

如果你想查询所有记录（包括已删除的），可以使用 withTrashed() 方法：

$allUsers = User::withTrashed()->get(); // 返回所有用户，包括已删除的

2. 恢复软删除的数据

如果某个用户误删了，你可以轻松恢复他们：

$user = User::onlyTrashed()->find(1); // 找到被软删除的用户
$user->restore(); // 恢复用户

3. 永久删除数据

如果你确定某些数据已经没有价值，可以使用 forceDelete() 方法将其永久删除：

$user = User::withTrashed()->find(1);
$user->forceDelete(); // 永久删除用户

📂 数据存档策略

软删除虽然方便，但长期保留大量软删除数据可能会导致性能问题。因此，我们需要设计一个合理的数据存档策略。

1. 定期清理旧数据

假设我们希望保留过去 6 个月内的软删除数据，超过这个时间的数据将被永久删除。可以通过定时任务来实现：

// app/Console/Kernel.php
protected function schedule(Schedule $schedule)
{
    $schedule->call(function () {
        User::onlyTrashed()
            ->where('deleted_at', '<=', now()->subMonths(6))
            ->forceDelete();
    })->daily(); // 每天执行一次
}

2. 将软删除数据迁移到存档表

如果你不想直接删除数据，可以将它们迁移到一个专门的存档表中。例如：

创建存档表

Schema::create('user_archives', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->timestamps();
    $table->softDeletes();
});

编写迁移逻辑

User::onlyTrashed()
    ->where('deleted_at', '<=', now()->subMonths(6))
    ->each(function ($user) {
        UserArchive::create([
            'name' => $user->name,
            'created_at' => $user->created_at,
            'updated_at' => $user->updated_at,
            'deleted_at' => $user->deleted_at,
        ]);
        $user->forceDelete(); // 迁移后永久删除原数据
    });

🎉 总结

通过今天的讲座，我们学习了 Laravel 的软删除功能及其时间戳管理方法，还探讨了如何制定数据存档策略。以下是关键点回顾：

软删除 是一种“假删除”方式，通过 deleted_at 字段标记记录状态。
使用 withTrashed()、onlyTrashed() 和 restore() 等方法可以灵活操作软删除数据。
为了优化性能，可以通过定时任务清理或迁移软删除数据。

希望今天的分享对你有所帮助！如果你有任何问题，欢迎随时提问 😊。下期再见！ 👋