讲师中心 微信公众号
AI工具推荐 视频效率加速

ThinkPHP模型作用域如何实现软删除数据过滤【模型】

大静同学_9645

大静同学_9645

发布时间:2026-06-29 15:39:49

|

865人浏览过

|

来源于php中文网

原创

ThinkPHP软删除由SoftDelete trait自动注入全局作用域实现,baseScope不参与也不应手动添加delete_time过滤;否则会导致冲突或覆盖withTrashed()效果。

thinkphp模型作用域如何实现软删除数据过滤【模型】

ThinkPHP 模型作用域(baseScope)本身不参与软删除过滤,真正起作用的是 SoftDelete trait 注入的全局作用域;如果你在 baseScope 里手动加了 where('delete_time', null),反而会导致重复过滤或冲突。

软删除过滤不是靠 baseScope 实现的

很多人误以为要重写 baseScope() 才能实现软删除过滤,其实完全不需要。ThinkPHP 6 的 SoftDelete 是通过 trait 自动注册一个隐藏的全局作用域(类似 Laravel 的 global scope),在所有查询生成 SQL 前自动注入 WHERE delete_time IS NULL 条件。

  • baseScope() 是你自定义的通用查询约束,比如默认查 status=1 的用户,它和软删除逻辑无关
  • 如果你在 baseScope() 里又写了 $query->where('delete_time', null),会导致条件叠加,可能查不到数据(尤其当字段类型不匹配时)
  • 真正影响软删行为的是模型是否启用 use SoftDelete; + $useSoftDelete = true; + 字段存在且类型正确

baseScope 与 withTrashed() 冲突怎么办

当你调用 User::withTrashed()->select() 却仍然查不到已软删记录,大概率是 baseScope() 里硬编码了删除状态判断,把 withTrashed() 的“移除过滤”给覆盖了。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载
  • 检查模型中是否重写了 baseScope(),删掉其中对 delete_time 或类似字段的手动 where
  • withTrashed() 必须放在链式调用最前面,例如 User::withTrashed()->where('status', 1)->select() 才有效;User::where('status', 1)->withTrashed() 无效
  • 如果必须保留 baseScope() 中的状态过滤,建议改用闭包方式动态控制:->where(function ($q) { $q->where('status', 1)->whereNull('delete_time'); }),避免和软删机制耦合

关联模型的作用域不会继承主模型的软删状态

主模型调用 withTrashed() 不会影响关联模型的查询逻辑——哪怕你在主模型里写了 baseScope(),子模型也只认自己的 SoftDelete 配置和它自己的 baseScope()。

立即学习“PHP免费学习笔记(深入)”;

  • 例如 User::withTrashed()->with('orders') 中,orders 仍按自身模型规则过滤(即只查 delete_time IS NULL 的订单)
  • 要让关联也包含软删数据,必须单独干预:要么在关联定义里加 ->withTrashed(),要么在 with() 闭包里写 function ($q) { $q->withTrashed(); }
  • 如果关联模型没启用 SoftDelete,withTrashed() 调用不会报错,但也不起作用——这点容易被忽略

真正决定软删行为的是字段是否存在、类型是否匹配、trait 是否启用这三者对齐;baseScope 是个干扰项,不是实现软删的必要环节,强行掺和反而容易踩坑。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

11064

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

6421

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2155

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

4068

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

4774

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

3751

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5377

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4222

2023.11.13

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

80

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn