ThinkPHP怎样配置软删除功能_软删除功能配置方法【数据】

ThinkPHP软删除失效？别慌，问题通常出在这三个环节的“错位”上

在ThinkPHP项目里，如果你明明启用了软删除，却发现数据还是被物理删除了，或者查询时总也过滤不掉那些“已删除”的记录，先别急着怀疑框架。这种情况，十有八九是模型配置、数据库字段和操作方式这三者没有严丝合缝地对齐。下面，我们就来一步步拆解，确保你的软删除功能坚如磐石。

一、数据库添加软删除字段

软删除功能的基石，是一个可以为空的时间标记字段。这个字段必须实实在在地躺在你的数据表里，而且类型要和框架预期的保持一致。默认情况下，这个字段名叫delete_time，在MySQL里，通常设置为DATETIME或TIMESTAMP类型，并且允许为NULL。

首先，执行SQL语句添加字段：ALTER TABLE user ADD delete_time DATETIME NULL DEFAULT NULL;

其次，如果你在使用迁移文件管理数据库结构，需要注意：ThinkPHP 6.x并不原生支持Lara vel风格的$table->softDeletes()写法。这个提示是为了兼容性考量，实际操作中，你还是得老老实实手写字段定义。

立即学习“PHP免费学习笔记（深入）”；

最后，也是很容易被忽略的一步：对已有表结构进行修改后，务必记得清空runtime/cache/目录。否则，模型可能还在使用缓存中的旧表结构，导致软删除逻辑根本不起作用。

二、模型类启用SoftDelete trait并声明配置

光在数据库加字段还不够，模型层也得同步“开机”。仅仅引入trait并不足以激活软删除，你必须在模型中显式启用它，同时还要留意别让它和自动时间戳功能“打架”。框架是通过trait注入行为来实现的，而不是一个全局开关。

第一步，在模型文件的顶部导入必要的命名空间：use think\model\concern\SoftDelete;

第二步，在模型类的定义中，声明使用这个trait，并设置启用标志：use SoftDelete; protected $useSoftDelete = true;

第三步，如果你的软删除字段不是默认的delete_time，比如用了deleted_at，那就需要特别指定：protected $deleteTime = 'deleted_at';

第四步，尤其要小心：如果模型同时启用了自动时间戳（即设置了$autoWriteTimestamp = true），千万别把delete_time字段错误地列入$createTime或$updateTime的配置中。否则，新记录一插入，这个字段就被写入了时间，造成“刚出生就被标记为删除”的尴尬局面。

三、验证字段类型与模型类型声明一致性

这一步是很多隐蔽问题的根源。数据库字段的类型，必须和模型中的类型声明完全匹配。如果这里对不上，框架内部进行条件比对（比如whereNotNull('delete_time')）时就会失败，导致软删除彻底失效。

情况一：如果数据库字段就是DATETIME类型，那么模型里保持默认即可，无需额外声明。

情况二：如果字段用的是BIGINT类型来存储时间戳整数，那么必须在模型中明确添加类型映射：protected $type = ['delete_time' => 'integer'];

情况三：绝对要避免将字段设置为NOT NULL DEFAULT CURRENT_TIMESTAMP。这样一来，所有新插入的记录，delete_time字段都会有一个默认值，会被框架误判为已删除状态，查询时根本找不到“正常”数据。

四、确保删除操作走模型方法而非Db类

这是一个关键性原则：软删除的逻辑只在模型层生效，Db类的操作会完全绕过这个机制，直接执行物理删除。所以，所有删除动作，都必须通过模型实例或模型的静态方法来触发。

来看看正确和错误的示范：

正确方式（触发软删除）：$user = User::find(123); $user->delete();

正确方式（批量软删除）：User::destroy([101, 102, 103]);

错误方式（导致真删）：Db::name('user')->where('id', 123)->delete();

错误方式（忽略模型逻辑）：User::where('id', 123)->delete(); （注意，这里虽然用了模型名，但调用的是查询构造器的delete方法，依然不会触发软删除）

五、配置查询默认行为与显式解除过滤

软删除一旦启用，就会改变模型的默认查询行为。所有通过模型进行的查询（比如select、find），都会自动加上WHERE delete_time IS NULL这个条件，帮你过滤掉已删除的数据。如果你想查看这些数据，就必须主动干预查询链。

第一，查询全部数据（包括已软删除的）：User::withTrashed()->select();

第二，只查询已被软删除的数据（类似回收站功能）：User::onlyTrashed()->select();

第三，如果你想恢复某条记录，必须先把它从“回收站”里找出来：$user = User::onlyTrashed()->find(123); if ($user) $user->restore();

最后提醒一下：withTrashed()和onlyTrashed()这两个方法，必须在select()或find()等最终查询方法之前调用，否则不会生效。而且，它们只影响当前这一次查询，并不会改变模型的默认行为。