🚀 Laravel 软删除功能的软删除数据定期清理与数据恢复自动化机制

大家好！欢迎来到今天的“Laravel 技术讲座”🎉。今天我们要聊聊一个非常实用的话题——如何在 Laravel 中优雅地处理软删除数据的定期清理和自动化恢复。如果你对软删除（Soft Delete）还不是很熟悉，别担心，我会从头到尾带你走一遍这个过程。

---

📝 什么是软删除？

首先，让我们简单回顾一下什么是软删除。在 Laravel 中，软删除是一种特殊的删除方式，它并不会真正从数据库中移除记录，而是通过设置一个 deleted_at 字段来标记该记录为“已删除”。这样做的好处是，你可以随时恢复这些被“删除”的数据。

举个例子：假设你有一个用户表，如果某个用户决定注销账户，你可能并不想完全删除他们的数据（比如他们之前的订单记录），而是希望保留下来以备后续使用。这时，软删除就派上用场了！

---

🔧 如何启用软删除？

在 Laravel 中启用软删除非常简单。只需在你的模型中使用 SoftDeletes trait，并确保你的数据库表中有 deleted_at 字段即可。

示例代码：

use IlluminateDatabaseEloquentModel;
use IlluminateDatabaseEloquentSoftDeletes;

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

    protected $dates = ['deleted_at']; // 声明 deleted_at 字段
}

同时，你需要确保你的迁移文件中包含 deleted_at 字段：

Schema::create('users', function (Blueprint $table) {
    $table->id();
    $table->string('name');
    $table->timestamps();
    $table->softDeletes(); // 添加 softDeletes 方法
});

---

🧹 定期清理软删除数据

虽然软删除可以保留数据，但随着时间推移，这些“已删除”的数据可能会堆积如山，占用大量存储空间。因此，我们需要一种机制来定期清理这些数据。

使用 Laravel 的任务调度

Laravel 提供了一个强大的任务调度系统，可以通过 Kernel.php 文件定义定时任务。我们可以编写一个 Artisan 命令或直接在调度器中执行清理逻辑。

示例代码：清理超过30天的软删除数据

// 在 app/Console/Commands/CleanSoftDeletedData.php 中
namespace AppConsoleCommands;

use IlluminateConsoleCommand;
use AppModelsUser;

class CleanSoftDeletedData extends Command
{
    protected $signature = 'clean:soft-deleted';
    protected $description = 'Clean up soft-deleted data older than 30 days';

    public function handle()
    {
        $deletedUsers = User::onlyTrashed() // 只查询被软删除的数据
            ->where('deleted_at', '<=', now()->subDays(30)) // 找出超过30天的数据
            ->get();

        foreach ($deletedUsers as $user) {
            $user->forceDelete(); // 强制删除
        }

        $this->info('Soft-deleted users cleaned successfully!');
    }
}

然后，在 app/Console/Kernel.php 中注册这个命令：

protected function schedule(Schedule $schedule)
{
    $schedule->command('clean:soft-deleted')->daily(); // 每天执行一次
}

现在，你的软删除数据会在每天凌晨自动清理掉超过30天的记录！🎉

---

🔄 数据恢复的自动化机制

有时候，我们可能需要将某些软删除的数据自动恢复。例如，如果某个用户只是暂时注销账户，我们可以在一定时间后自动恢复他们的账户。

示例代码：自动恢复被软删除的用户

// 在 app/Console/Commands/RestoreSoftDeletedUsers.php 中
namespace AppConsoleCommands;

use IlluminateConsoleCommand;
use AppModelsUser;

class RestoreSoftDeletedUsers extends Command
{
    protected $signature = 'restore:soft-deleted-users';
    protected $description = 'Restore soft-deleted users within the last 7 days';

    public function handle()
    {
        $recentlyDeletedUsers = User::onlyTrashed()
            ->where('deleted_at', '>=', now()->subDays(7)) // 找出最近7天内被删除的用户
            ->get();

        foreach ($recentlyDeletedUsers as $user) {
            $user->restore(); // 恢复用户
        }

        $this->info('Soft-deleted users restored successfully!');
    }
}

同样地，注册这个命令到调度器中：

protected function schedule(Schedule $schedule)
{
    $schedule->command('restore:soft-deleted-users')->hourly(); // 每小时执行一次
}

---

📊 总结表格

功能	描述	示例代码方法
启用软删除	通过 SoftDeletes trait 和 deleted_at 字段实现	use SoftDeletes;
定期清理软删除数据	使用 onlyTrashed() 查询软删除数据，并结合 forceDelete() 删除	User::onlyTrashed()
自动恢复软删除数据	使用 restore() 方法恢复软删除数据	User::restore()

---

🌐 国外技术文档引用

1. Laravel 官方文档：提到软删除时，官方文档指出，SoftDeletes trait 是实现软删除的核心工具。
2. Taylor Otwell（Laravel 创始人）在一篇博客中提到，软删除的最佳实践之一是定期清理旧数据，以避免性能问题。
3. Jeffrey Way（Laracasts 创始人）在他的视频教程中演示了如何通过任务调度清理软删除数据。

---

好了，今天的讲座到这里就结束了！希望你能学会如何在 Laravel 中优雅地处理软删除数据的定期清理和自动化恢复。如果你有任何问题，欢迎在评论区留言，我会尽力解答！👋