PHP软删除可通过四种方法实现:一、Eloquent的SoftDeletes Trait配合deleted_at字段;二、手动维护is_deleted布尔字段;三、用作用域统一过滤软删除记录;四、通过数据库视图隔离未删除数据。

如果在PHP应用中需要保留数据记录但又不希望其在业务逻辑中被显示或使用,则可以通过软删除机制实现。软删除通常不真正从数据库中移除记录,而是通过标记字段(如is_deleted、deleted_at等)来标识该记录已被逻辑删除。以下是实现PHP软删除的多种方法:
一、使用deleted_at时间戳字段配合Eloquent ORM
Laravel框架的Eloquent ORM原生支持软删除,通过在模型中引入SoftDeletes Trait,并在数据库表中添加deleted_at字段,即可自动拦截delete操作并写入删除时间。
1、在数据库迁移文件中为数据表添加deleted_at字段:
使用Schema::table()添加nullable的timestamp类型字段,字段名为deleted_at。
2、在对应的Eloquent模型类中引入SoftDeletes Trait:
在类声明下方添加use Illuminate\Database\Eloquent\SoftDeletes;并在class定义中加入use SoftDeletes;
立即学习“PHP免费学习笔记(深入)”;
3、执行删除操作时调用模型实例的delete()方法:
此时Eloquent不会执行DELETE SQL,而是执行UPDATE语句将deleted_at设为当前时间戳。
4、查询时默认自动排除已软删除的记录:
除非显式调用withTrashed()或onlyTrashed(),否则all()、find()等方法均不返回deleted_at非NULL的行。
5、恢复软删除记录可调用restore()方法:
该方法将deleted_at字段重置为NULL,使记录重新进入正常查询范围。
二、手动维护is_deleted布尔字段
在不依赖ORM软删除特性的场景下,可自行设计is_deleted(TINYINT(1)或BOOLEAN)字段,通过显式条件控制数据可见性与操作行为,适用于原生PDO、MySQLi或自定义DAO层。
1、在目标数据表中新增is_deleted字段:
字段类型设为TINYINT(1),默认值为0,表示未删除。
2、所有SELECT语句WHERE子句中追加AND is_deleted = 0条件:
必须确保每个业务查询都包含此过滤条件,否则会暴露已删除数据。
3、执行删除操作时改用UPDATE语句:
将对应记录的is_deleted值更新为1,而非使用DELETE语句。
4、在DAO方法中封装delete逻辑:
例如编写deleteById($id)方法,内部执行UPDATE table_name SET is_deleted = 1 WHERE id = ? AND is_deleted = 0。
5、提供restoreById($id)方法用于恢复:
执行UPDATE table_name SET is_deleted = 0 WHERE id = ? AND is_deleted = 1。
三、使用作用域(Scope)统一处理软删除状态
在支持查询构建器的框架(如Laravel)中,可通过本地作用域或全局作用域强制注入软删除过滤条件,避免在每个查询中重复书写WHERE子句,降低遗漏风险。
1、在模型中定义本地作用域scopeNotDeleted():
在方法内调用$where('is_deleted', 0)或$whereNull('deleted_at'),视字段类型而定。
2、在业务代码中使用该作用域替代原始查询:
例如User::notDeleted()->get()或User::notDeleted()->where('status', 1)->first()。
3、定义全局作用域并在boot()方法中注册:
创建一个实现Illuminate\Database\Eloquent\Scope接口的类,在apply()中添加统一的软删除条件。
4、启用全局作用域后,所有对该模型的查询自动附加软删除过滤:
需注意:withTrashed()和onlyTrashed()可临时绕过全局作用域。
5、对关联查询也应考虑作用域继承:
在定义belongsTo/hasMany关系时,可在关系方法中链式调用->withoutGlobalScopes()或显式添加where条件。
四、数据库视图隔离软删除数据
通过MySQL视图抽象出仅包含未删除记录的结果集,使上层应用无需感知软删除字段的存在,所有CRUD操作面向视图进行,由数据库层完成过滤与转换。
1、为原始表创建VIEW,名称如table_name_active:
SQL语句为CREATE VIEW table_name_active AS SELECT * FROM table_name WHERE is_deleted = 0;
2、应用程序中所有读取操作均针对该视图而非基表:
例如SELECT * FROM table_name_active WHERE status = 'published';
3、INSERT操作仍指向原始表:
因为视图通常不可直接插入,需保持基表写入路径不变。
4、UPDATE操作需区分是否涉及软删除字段:
若仅更新业务字段,可继续操作基表;若需“删除”,则UPDATE基表的is_deleted字段。
5、为保障一致性,应在基表上设置BEFORE UPDATE触发器:
当尝试将is_deleted由1改为0时,检查是否存在同名唯一约束冲突或其他业务限制。











