在ThinkPHP8中查询逻辑删除记录需用withTrashed()获取全部数据或onlyTrashed()精准查已删数据，二者不可混用；恢复记录须先通过onlyTrashed()查出再调用restore()实例方法。
在ThinkPHP8中查询已被逻辑删除的记录时，必须显式绕过软删除默认过滤机制，否则即使数据真实存在deleted_at值也不会出现在结果里——这是因为框架在模型层自动注入了deleted_at IS NULL条件，且该拦截发生在SQL生成前，无法被后续where覆盖。
启用软删除并配置字段
在模型类中引入SoftDelete trait，并声明软删除字段为deleted_at（TP8默认识别该字段名）：
use think\model\concern\SoftDelete;
class User extends Model {
use SoftDelete;
protected $deleteTime = 'deleted_at';
protected $type = ['deleted_at' => 'datetime'];
}
立即学习“PHP免费学习笔记（深入）”；
【deleted_at字段必须是DATETIME或TIMESTAMP类型且允许NULL】 若用INT存时间戳，TP8内部DateTime比对会失败，导致onlyTrashed()永远查不到数据。
数据库表中该字段需已存在：ALTER TABLE user ADD deleted_at DATETIME NULL DEFAULT NULL;
基础查询：包含已删数据
调用withTrashed()移除deleted_at IS NULL条件，获取全部记录（含deleted_at非空）：
User::withTrashed()->select();
User::withTrashed()->where('status', 1)->find();
【withTrashed()必须是链式调用的第一个方法】 写成User::where('id', 5)->withTrashed()->find()将无效，因为where已触发条件固化，后续withTrashed()无法修改已生成的WHERE子句。
精准定位：只查已软删除的数据
使用onlyTrashed()替代默认过滤逻辑，生成deleted_at IS NOT NULL条件：
第一步：执行查询
User::onlyTrashed()->select();
第二步：可叠加其他条件（注意此时deleted_at已被锁定为非空）
User::onlyTrashed()->where('created_at', '>', '2025-01-01')->select();
第三步：支持分页与聚合
User::onlyTrashed()->count();
这一步不能和withTrashed()混用——User::onlyTrashed()->withTrashed()等价于withTrashed()，前者被后者覆盖。
关联查询中启用软删除穿透
主模型调用withTrashed()不影响关联模型，默认仍过滤已删数据。需在关联定义或预载闭包中单独声明：
方法一：在关联方法内硬编码
public function posts() {
return $this->hasMany(Post::class)->withTrashed();
}
方法二：动态预载时传入闭包
User::with(['posts' => function ($query) {
$query->withTrashed();
}])->find(1);
注意：若Post模型未启用SoftDelete，withTrashed()调用无效果也不报错，需先确认子模型已正确配置trait与$deleteTime。
恢复单条软删除记录
restore()是模型实例方法，仅对当前实例生效，且要求deleted_at字段当前值非NULL：
$user = User::onlyTrashed()->find(1);
if ($user) {
$user->restore();
}
直接对普通查询结果调用restore()会静默失败——User::find(1)->restore()不生效，因该记录deleted_at为NULL，不符合恢复前提。
