ThinkPHP模型软删除_批量恢复删除的数据【操作】

落明同学_9041

落明同学_9041

2026-05-02

163人浏览

原创

查不到软删数据是因为默认查询自动过滤delete_time非空记录,必须用user::onlytrashed()->where('id',123)->find()显式查询;restoreall()方法不存在,批量恢复需db::update清空delete_time或先查集合再逐条restore。

thinkphp模型软删除_批量恢复删除的数据【操作】

查不到软删数据?先确认是否用了 onlyTrashed()

默认查询会自动过滤掉 delete_time 非空的记录,所以 User::where('id', 123)->find() 查不到已软删的数据,不是数据丢了,是被框架主动屏蔽了。必须显式加 onlyTrashed() 才能定位目标:

  • User::onlyTrashed()->where('id', 123)->find() —— 只查已软删的
  • User::withTrashed()->where('id', 123)->find() —— 查全部(含软删)
  • 这两个方法必须在 find() 或 select() 前链式调用,否则无效
  • 如果模型没启用 SoftDelete trait,或数据库字段类型不是 DATETIME NULL,onlyTrashed() 查询结果为空,但不会报错

别信 restoreAll() —— 它根本不存在

ThinkPHP 5.x 和 6.x 的模型类里没有 restoreAll() 方法。任何类似 User::restoreAll() 的写法都会直接报错:Call to undefined method。网上看到的大多是旧版 TP3 的误传,或是开发者自己封装的扩展。

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

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

下载
  • 批量恢复只有两条路:走模型逻辑(触发事件、校验),或绕过模型(快但无钩子)
  • 想触发 restoring/restored 事件,得先查出集合再逐条调用:User::onlyTrashed()->chunk(500, function ($items) { $items->each->restore(); });
  • 不关心事件,只要结果,直接用 Db::name('user')->where('delete_time', 'not null')->update(['delete_time' => null])
  • TP 6.x 中 User::onlyTrashed()->update(['delete_time' => null]) 是合法写法;TP 5.x 则需改用 save() 或 Db 类

restore() 静默失败?检查字段配置和数据库约束

restore() 是模型实例方法,调用后不报错、不抛异常,但可能什么都没做——最常见原因是软删字段没对齐。

  • 模型中必须有 use SoftDelete;,且 protected $deleteTime = 'delete_time';(若字段名不同,如 is_deleted,必须同步修改)
  • 数据库字段必须是可空类型:delete_time DATETIME NULL,不能设 NOT NULL DEFAULT '0000-00-00 00:00:00',否则 MySQL 严格模式下写入 null 会失败
  • 若字段是整型时间戳(如 BIGINT),模型中还得加 protected $type = ['delete_time' => 'integer'];,否则 null 会被转成字符串再强转为 0,导致后续仍被判定为已删除
  • 调用前务必验证存在性:User::onlyTrashed()->where('id', 123)->value('id') 返回非 null 再执行 restore()

按条件批量恢复,别链式调用 restore()

User::where('status', 1)->onlyTrashed()->restore() 这种写法是错的。restore() 不接受查询构造器链式结果,它只认模型实例。强行这么写,要么报错,要么静默跳过。

  • 安全做法是先取 ID 列表:$ids = User::onlyTrashed()->where('status', 1)->column('id');,再 Db::name('user')->where('id', 'in', $ids)->update(['delete_time' => null])
  • 如果必须走模型逻辑(比如要恢复关联数据),就分两步:$users = User::onlyTrashed()->where('status', 1)->select();,然后遍历 $user->restore()
  • 事务场景下,多张表恢复时注意字段名大小写、NULL 处理是否统一,尤其跨模型时容易因 $deleteTime 配置不一致导致部分表恢复失败
  • MySQL 开启 STRICT_TRANS_TABLES 时,delete_time 字段若被误设为 NOT NULL,update 操作会直接中断,整个事务回滚

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

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

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

下载

相关标签:

php thinkphp

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

相关专题

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

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

2023.09.01

11324

6

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

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

2023.10.11

6561

5

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

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

2023.10.11

2155

5

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

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

2023.10.23

4148

4

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

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

2023.10.23

4874

6

html怎么上传
html怎么上传

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

2023.11.03

3811

9

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

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

2023.11.09

5497

8

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

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

2023.11.13

4302

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12242

4

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习