如何配置ThinkPHP实现数据软删除功能？

本文共计1048个文字，预计阅读时间需要5分钟。

如果在使用ThinkPHP项目中启用软删除功能但数据仍然被物理删除，或查询时无法正确过滤已删除记录，可能是模型配置、数据库字段、操作方式三者未严格对齐。以下是配置软删除功能的步骤：

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

软删除依赖一个可为空的时间标记字段，该字段必须存在于对应数据表中，且类型与框架预期一致。字段名默认为delete_time，MySQL中需设为DATETIME或TIMESTAMP类型，并允许NULL值。

1、执行SQL语句添加字段：ALTER TABLE user ADD delete_time DATETIME NULL DEFAULT NULL;

2、若使用迁移文件，应调用$table->softDeletes()（注意：ThinkPHP 6.x不支持Laravel风格迁移写法，此为兼容提示，实际应手写字段定义）。

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

3、已有表修改字段后，必须清空runtime/cache/目录，否则模型可能缓存旧结构导致软删除逻辑失效。

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

仅引入trait不足以激活软删除，必须在模型中显式启用并确保与自动时间戳机制无冲突。框架通过trait注入行为，而非全局开关驱动。