信息发布→ 登录 注册 退出

Laravel中的软删除(Soft Deletes)如何使用和恢复数据

发布时间:2025-11-16

点击量:
在 Laravel 中,软删除通过标记 deleted_at 字段实现数据可恢复性。需在迁移中添加 softDeletes() 字段并在模型中引入 SoftDeletes trait。调用 delete() 时设置 deleted_at 而非物理删除,默认查询不包含已删除记录。使用 withTrashed() 可查含已删数据,onlyTrashed() 仅查已删数据。通过 restore() 恢复数据,forceDelete() 则永久删除。适用于需保留历史或实现回收站功能的场景。

在 Laravel 中,软删除(Soft Deletes)是一种让数据“看似”被删除,但实际上保留在数据库中的机制。它通过标记一条记录为已删除,而不是真正从数据库中移除,从而实现数据的可恢复性。

启用软删除

要在模型中使用软删除,需要执行以下步骤:

  • 在对应的数据库迁移文件中添加 deleted_at 字段
  • 在模型类中引入 Illuminate\Database\Eloquent\SoftDeletes trait

例如,为 users 表添加软删除支持:

1. 创建迁移:

Schema::table('users', function (Blueprint $table) {
    $table->softDeletes();
});

运行迁移后,会在 users 表中添加一个 deleted_at 时间戳字段。

2. 在模型中使用 SoftDeletes:

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;

class User extends Model
{
    use SoftDeletes;
}

完成以上设置后,调用 $user->delete() 不会真正删除记录,而是将 deleted_at 设置为当前时间。

查询软删除的数据

默认情况下,Eloquent 查询不会返回已被软删除的记录。但你可以通过以下方式查看它们:

  • withTrashed():包含已删除的记录
  • onlyTrashed():只获取已删除的记录

示例:

// 获取所有用户,包括已删除的
$users = User::withTrashed()->get();

// 只获取已删除的用户
$trashedUsers = User::onlyTrashed()->get();

恢复软删除的数据

使用 restore() 方法可以将软删除的记录恢复,即将 deleted_at 字段清空。

示例:

// 恢复单个已删除用户
$user = User::onlyTrashed()->find(1);
$user->restore();

// 或链式调用
User::withTrashed()->where('id', 1)->restore();

你也可以在关联模型中恢复数据,只要该模型启用了软删除。

强制删除(彻底删除)

如果确实需要永久删除某条记录,可以使用 forceDelete() 方法:

$user->forceDelete();

这个操作不可逆,数据将从数据库中彻底移除。

基本上就这些。软删除适合需要保留历史数据或支持“回收站”功能的场景,合理使用能提升系统的安全性和用户体验。注意在做数据恢复时,确保业务逻辑正确处理状态变化。不复杂但容易忽略细节。

标签:# laravel  # ai  # 数据恢复  # delete  # database  # 数据库  # 数据库中  # 链式  # 移除  # 恢复性  # 是一种  # 已被  # 适用于  # 会在  # 并在  # 要在  
在线客服
服务热线

服务热线

4008888355

微信咨询
二维码
返回顶部
×二维码

截屏,微信识别二维码

打开微信

微信号已复制,请打开微信添加咨询详情!