thinkphp5.1启用软删除需模型、字段、调用三者严格对齐：数据库加可空datetime型delete_time字段；模型引入softdelete trait并配置$usesoftdelete、$deletetime；删除必须用模型方法（如delete()或destroy()），禁用db类；查询默认过滤已删数据，可用withtrashed()或onlytrashed()控制；字段类型不匹配须在$type中声明映射。
在ThinkPHP5.1中启用软删除功能，必须让模型类、数据库字段、调用方式三者严格对齐，缺一不可——只加trait不配字段会静默失效，只改数据库不走模型方法等于白设，字段类型错配会导致软删后查不到数据或新记录一入库就被判“已删除”。
第一步：数据库添加delete_time字段
执行SQL语句，在对应数据表中新增软删除标记字段：
ALTER TABLE user ADD delete_time DATETIME NULL DEFAULT NULL;
注意：字段类型必须为可空的DATETIME（或TIMESTAMP），【严禁设置NOT NULL或DEFAULT CURRENT_TIMESTAMP】。否则新插入记录时delete_time自动带值，框架会误判该记录已被删除，导致刚保存就查不出来。
已有数据表修改后，必须清空runtime/cache/目录，否则模型仍按旧结构缓存，软删除逻辑不会触发。
第二步：模型中启用SoftDelete trait
打开目标模型文件（如app/index/model/User.php），完成以下三件事：
① 在文件顶部引入命名空间：
use think\model\concern\SoftDelete;
② 在类定义中声明trait并显式启用：
use SoftDelete;
protected $useSoftDelete = true;
③ 明确指定字段名（即使使用默认名delete_time也建议写上）：
protected $deleteTime = 'delete_time';
若模型已启用自动时间戳（$autoWriteTimestamp = true），切勿将delete_time加入$createTime或$updateTime数组，否则新增记录时该字段会被自动写入，等同于立即软删。
第三步：确保删除操作走模型层
方法一：通过模型实例删除
$user = User::get(123);
$user->delete();
方法二：通过静态destroy方法删除
User::destroy(123);
【绝对禁止直接使用Db类】：Db::name('user')->where('id', 123)->delete(); 这种写法完全绕过模型逻辑，执行的是物理删除，且不触发任何软删相关钩子。
补充：如果需要批量软删，可用destroy传数组或闭包：
User::destroy([1, 2, 3]);
User::destroy(function ($query) { $query->where('status', 0); });
第四步：查询时控制是否包含已软删数据
默认情况下，所有find()、select()都会自动过滤delete_time非NULL的记录，即查不到已软删数据。
查全部（含已删）：
User::withTrashed()->select();
只查已删：
User::onlyTrashed()->select();
恢复单条记录：
$user = User::onlyTrashed()->find(123);
$user->restore();
注意：restore()不触发save事件钩子，字段值不会重置；若需彻底还原并触发钩子，应先restore再手动调用save()。
第五步：验证字段类型与模型声明是否一致
若数据库字段为BIGINT存储时间戳，模型中必须声明类型映射：
protected $type = ['delete_time' => 'integer'];
否则框架内部将字符串化处理时间戳，最终写入数据库的常为0，导致软删失效且无报错提示。
若字段是DATETIME类型，无需额外声明$type，保持默认即可。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
