Laravel怎么实现软删除功能_Laravel如何恢复已删除数据【实战】-Laravel-PHP中文网

软删除需同时具备SoftDeletes trait和deleted_at字段，否则delete()为硬删或报错；restore()仅对软删除记录有效，且默认不触发事件，查询默认忽略软删除数据。

laravel怎么实现软删除功能_laravel如何恢复已删除数据【实战】

不加这个 trait，调用 delete() 就是真删；加了但没加数据库字段，会报错或静默失败。Laravel 的软删除本质是给记录打个时间戳标记，不是改逻辑。

模型里必须 use Illuminate\Database\Eloquent\SoftDeletes; 并在 class 声明中加上 use SoftDeletes;
数据表必须有 deleted_at 字段，类型为 TIMESTAMP NULL（MySQL）或 datetime null（SQLite/PostgreSQL）
如果字段名不是 deleted_at，得在模型里显式定义：protected $dates = ['deleted_at']; 并重写 getDeletedAtColumn() 方法

调用 restore() 后查不到数据？大概率是这条记录根本没被软删除过——比如之前是硬删，或者 forceDelete() 过，那它就彻底没了，restore() 无效。

restore() 不会触发 restoring / restored 事件，除非你手动开启：在模型里加 protected $dispatchesEvents = ['restored' => Restored::class];
批量恢复要用 withTrashed()->where(...)->restore()，直接 Model::where(...)->restore() 会报错，因为没查到软删除数据
restore() 不会自动清理关联模型的 deleted_at，父子关系需自行处理

你查不到“已删除”的记录，不是代码写错了，是 Laravel 默认行为。它会在所有 SELECT 语句里自动加 WHERE deleted_at IS NULL。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

查全部（含软删）：用 withTrashed()，例如 User::withTrashed()->find(123)
只查软删的：用 onlyTrashed()，例如 User::onlyTrashed()->where('email', 'x@y.z')->first()
关联查询也受限制：如果父模型用了软删除，$user->posts 默认不会返回已软删的 posts，得在关系方法里加 ->withTrashed()

一旦执行 forceDelete()，数据从数据库物理消失，restore() 完全无效。这不是“更彻底的删除”，而是放弃软删除机制的明确选择。

常见误操作：在控制器里写 $model->delete() 后又想 restore()，结果发现没生效——其实是之前某处调过 forceDelete() 或迁移时漏建 deleted_at 字段
软删除状态下，delete() 等价于 touch('deleted_at')；而 forceDelete() 会跳过所有软删除逻辑，走原生 DELETE FROM
测试环境容易忽略这点：seeders 里如果用了 forceDelete()，后续 restore() 相关测试必然失败