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

大家好！👋 今天我们要来聊聊 Laravel 中的软删除功能（Soft Delete），以及如何优雅地处理软删除数据的定期清理和数据恢复的自动化机制。如果你对 Laravel 的 Eloquent ORM 已经有所了解，那么这篇文章会让你更加得心应手！💪

---

🌟 什么是软删除？

软删除并不是真正从数据库中删除数据，而是通过在表中添加一个 deleted_at 字段，标记该记录是否已被“逻辑删除”。换句话说，软删除只是把数据隐藏起来，而不是彻底销毁。

举个栗子：假设你有一个用户表，某个用户注销了账户，但你又不想丢失他的历史数据（比如订单记录）。这时候，软删除就派上用场啦！

---

🔧 如何启用软删除？

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

数据库迁移文件

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

模型定义

use IlluminateDatabaseEloquentModel;
use IlluminateDatabaseEloquentSoftDeletes;

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

    protected $dates = ['deleted_at']; // 确保 deleted_at 被识别为日期时间字段
}

---

🔄 数据恢复的自动化机制

有时候，我们希望某些被软删除的数据能够自动恢复。比如，如果用户的账户被误删，我们可以在一定时间后自动恢复它。

使用 Laravel 的 Jobs 和 Queues

我们可以创建一个 Job 来实现数据恢复的自动化。以下是一个简单的例子：

创建 Job

php artisan make:job RestoreDeletedUsers

编写 Job 逻辑

namespace AppJobs;

use IlluminateBusQueueable;
use IlluminateContractsQueueShouldQueue;
use IlluminateFoundationJobsJob;
use AppModelsUser;

class RestoreDeletedUsers extends Job implements ShouldQueue
{
    use Queueable;

    public function handle()
    {
        // 恢复最近 24 小时内被软删除的用户
        $deletedUsers = User::onlyTrashed() // 获取所有被软删除的用户
            ->where('deleted_at', '>', now()->subDay())
            ->get();

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

定期执行 Job

使用 Laravel 的任务调度器（Task Scheduler）来定期执行这个 Job：

protected function schedule(Schedule $schedule)
{
    $schedule->job(new RestoreDeletedUsers)->daily(); // 每天运行一次
}

💡 小贴士：你可以根据业务需求调整恢复的时间范围，比如 7 天、30 天等。

---

🗑️ 软删除数据的定期清理策略

随着时间推移，软删除的数据可能会越来越多，占用大量存储空间。因此，我们需要一个定期清理策略。

使用 Eloquent 的 forceDelete 方法

Laravel 提供了一个 forceDelete 方法，可以永久删除软删除的数据。我们可以结合任务调度器来实现定期清理。

示例代码

protected function schedule(Schedule $schedule)
{
    $schedule->call(function () {
        // 删除 30 天前被软删除的用户
        User::onlyTrashed()
            ->where('deleted_at', '<=', now()->subDays(30))
            ->forceDelete();
    })->daily(); // 每天运行一次
}

⚠️ 注意：forceDelete 是不可逆的操作，请务必小心使用！

---

📊 表格对比：软删除 vs. 硬删除

功能	软删除	硬删除
数据是否保留	是，数据仅被标记为已删除	否，数据从数据库中彻底删除
性能影响	较低，查询时会额外检查 deleted_at	高效，直接操作数据库
使用场景	需要保留历史记录	不需要保留历史记录
恢复可能性	可以通过 restore 方法恢复	不可恢复

---

🛠️ 进阶技巧：自定义软删除行为

如果你觉得默认的 deleted_at 字段不够灵活，可以通过重写模型中的方法来自定义软删除逻辑。

自定义字段名

protected function initializeSoftDeletes()
{
    $this->setDeletedAtColumn('custom_deleted_at'); // 修改字段名为 custom_deleted_at
}

自定义删除逻辑

public function delete()
{
    // 在删除之前执行一些额外操作
    $this->update(['status' => 'inactive']);

    parent::delete(); // 调用父类的 delete 方法
}

---

🎉 总结

今天我们学习了 Laravel 中软删除功能的核心概念，以及如何通过任务调度器实现软删除数据的定期清理和数据恢复的自动化机制。以下是关键点回顾：

1. 软删除的基础：通过 SoftDeletes trait 和 deleted_at 字段实现。
2. 数据恢复自动化：使用 Jobs 和 Queues 实现定时恢复。
3. 定期清理策略：通过 forceDelete 方法删除过期的软删除数据。
4. 进阶技巧：自定义软删除字段名和逻辑。

希望这篇文章能让你对 Laravel 的软删除功能有更深入的理解！如果有任何问题或建议，欢迎留言讨论哦~ 😊

---

参考资料：

• Laravel 官方文档（国外技术文档）
• Taylor Otwell 的 GitHub 仓库