Laravel软删除通过添加deleted_at字段和使用SoftDeletes trait实现，调用delete()时填充该字段而不真正删除数据，查询默认忽略已删除记录，可用withTrashed()或onlyTrashed()获取包含或仅含已删除数据，restore()方法可恢复数据，forceDelete()则永久删除记录。
Laravel 的 Eloquent ORM 提供了“软删除”功能，允许你标记数据为已删除，而不是真正从数据库中移除。这样可以在需要时恢复数据，同时保持数据完整性。实现软删除非常简单，只需几个步骤即可完成。
要在模型中启用软删除，需执行以下操作：
softDeletes() 方法创建迁移。php artisan make:migration add_deleted_at_to_users_table --table=users
在迁移文件中：
public function up()
{
Schema::table('users', function (Blueprint $table) {
$table->softDeletes();
});
}
然后运行迁移命令：
php artisan migrate
接着在模型中使用 SoftDeletes trait：
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;
class User extends Model
{
use SoftDeletes;
}
启用软删除后，调用模型的 delete() 方法不会真正删除记录，而是将 deleted_at 字段设置为当前时间戳。
$user = User::find(1); $user->delete(); // 此时 deleted_at 被填充，数据仍存在于数据库
查询时，Eloquent 会自动过滤掉已软删除的记录，即默认查询只返回未删除的数据。
你可以通过特定方法访问已被软删除的数据：
// 获取所有用户，包括已删除的 $users = User::withTrashed()->get(); // 只获取已删除的用户 $trashedUsers = User::onlyTrashed()->get();
使用 restore() 方法可以将软删除的数据恢复，即将 deleted_at 字段清空。
// 恢复单个已删除的用户
$user = User::withTrashed()->find(1);
$user->restore();
// 批量恢复
User::onlyTrashed()->where('active', 0)->restore();
注意：调用 restore() 后，deleted_at 值会被设为 null，该记录重新参与常规查询。
如果希望彻底删除某条记录，绕过软删除机制，可使用 forceDelete() 方法。
$user = User::find(1); $user->forceDelete(); // 数据从数据库中永久移除
对已软删除的记录再次调用 forceDelete() 也会将其永久删除。
基本上就这些。Laravel 软删除机制简洁实用，适合需要保留历史数据或支持数据回滚的场景。只要记得加字段、引入 trait，并合理使用查询作用域，就能轻松管理删除与恢复逻辑。
以上就是Laravel如何使用软删除（Soft Deletes）功能_Eloquent软删除与数据恢复方法的详细内容，更多请关注php中文网其它相关文章！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
240
收藏
