Laravel软删除如何实现_Laravel SoftDeletes使用详解-Laravel-PHP中文网

Laravel软删除如何实现_Laravel SoftDeletes使用详解

裘德小鎮的故事

发布： 2025-12-09 17:07:15

原创

571人浏览过

Laravel的软删除通过SoftDeletes trait实现，模型引入该trait并添加deleted_at字段即可标记删除而不移除记录，便于数据恢复与完整性维护。

laravel软删除如何实现_laravel softdeletes使用详解

Laravel 的软删除（Soft Deletes）是一种优雅的方式，用来标记数据为“已删除”，而不会真正从数据库中移除记录。这样可以在需要时恢复数据，同时保持数据完整性。Laravel 通过 SoftDeletes trait 提供了开箱即用的支持，使用起来非常简单。

启用软删除功能

要在模型中启用软删除，只需在对应的 Eloquent 模型中引入 Illuminate\Database\Eloquent\SoftDeletes trait，并确保数据表包含一个 deleted_at 字段。

示例：启用软删除的 User 模型

<?php

namespace App\Models;

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

class User extends Model
{
    use SoftDeletes;

    protected $dates = ['deleted_at']; // 可选：如果使用 $dates，可直接操作 Carbon 实例
}

登录后复制

注意： Laravel 6+ 中，$dates 属性不再是必须的，Eloquent 会自动识别 deleted_at 为日期类型。

数据库迁移中添加 deleted_at 字段

要支持软删除，数据表必须包含一个 nullable 的 deleted_at 字段。可以使用迁移文件中的 softDeletes() 方法来添加它。

示例：创建用户表并添加软删除字段

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreateUsersTable extends Migration
{
    public function up()
    {
        Schema::create('users', function (Blueprint $table) {
            $table->id();
            $table->string('name');
            $table->string('email')->unique();
            $table->timestamp('deleted_at')->nullable(); // 手动写法
            // 或者使用下面这行：
            // $table->softDeletes();
            $table->timestamps();
        });
    }

    public function down()
    {
        Schema::dropIfExists('users');
    }
}

登录后复制

提示： 使用 $table->softDeletes(); 是更简洁的方式，它会自动生成一个 nullable 的 timestamp 类型的 deleted_at 字段。

执行软删除与恢复

一旦模型启用了软删除，调用 delete() 方法不会真正删除记录，而是将 deleted_at 设置为当前时间。

示例：执行软删除

$user = User::find(1);
$user->delete(); // 此时 deleted_at 被设置，数据仍在数据库中

登录后复制

要恢复已被软删除的记录，可以调用 restore() 方法。

Narration Box

Narration Box是一种语音生成服务，用户可以创建画外音、旁白、有声读物、音频页面、播客等

查看详情

示例：恢复已删除的记录

$user = User::withTrashed()->find(1);
$user->restore(); // 恢复数据，deleted_at 设为 null

登录后复制

说明：

delete()：设置 deleted_at 时间戳
restore()：清除 deleted_at，恢复数据
forceDelete()：彻底删除记录，绕过软删除

查询软删除数据

默认情况下，启用了软删除的模型查询会自动排除已被删除的记录。但你可以使用以下方法控制查询行为：

withTrashed()：包含已被软删除的记录
onlyTrashed()：只查询已被软删除的记录
withoutTrashed()：排除软删除数据（默认行为）

示例：不同查询方式

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

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

// 恢复某个已删除用户
User::onlyTrashed()->where('email', 'test@example.com')->restore();

登录后复制

强制删除（永久删除）

如果你确定要永久删除某条记录，可以使用 forceDelete() 方法。

$user = User::find(1);
$user->forceDelete(); // 数据从数据库中彻底删除

登录后复制

对已经软删除的数据再次调用 forceDelete() 也会将其永久移除。

软删除事件

Laravel 的软删除会触发特定的模型事件：

deleting 和 deleted：在 delete() 调用时触发（软删除也触发）
restoring 和 restored：在 restore() 调用时触发

你可以在模型中监听这些事件，用于清理关联数据或记录日志。

protected static function booted()
{
    static::deleted(function ($user) {
        // 删除用户时，清理其文章草稿
        $user->drafts()->delete();
    });

    static::restored(function ($user) {
        // 恢复用户时，重新激活其账号状态
        $user->update(['status' => 'active']);
    });
}

登录后复制

基本上就这些。软删除在实际项目中非常实用，比如用户注销、内容回收站等场景。只要记得加字段、用 trait、理解查询作用域，就能轻松掌握。

以上就是Laravel软删除如何实现_Laravel SoftDeletes使用详解的详细内容，更多请关注php中文网其它相关文章！