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

ThinkPHP批量写入怎么写_ThinkPHP模型批量保存技巧【汇总】

小伟大大_1554

小伟大大_1554

发布时间:2026-05-02 06:34:01

|

433人浏览过

|

来源于php中文网

原创

saveAll()只插一条或报错,因其本质是循环调用单条save(),每条均执行验证、事件、自动时间戳等完整模型生命周期;任一条数据验证失败、字段不匹配或钩子异常即中断,且默认不回滚。

thinkphp批量写入怎么写_thinkphp模型批量保存技巧【汇总】

saveAll() 为什么只插了一条或直接报错

ThinkPHP 的 saveAll() 看似简单,但实际行为高度依赖模型定义和数据结构。它不是“把数组全塞进去”,而是对每个元素调用 save(),所以每条数据都走完整模型生命周期:验证、自动写入、事件钩子、字段过滤。

常见失败点:

  • saveAll() 传入的数组里,某条数据触发了验证失败(比如空邮箱),整个操作就中断,前面成功的也不会回滚 —— 默认不开启事务
  • 数据字段不统一,比如第一条有 ['name', 'email'],第二条多出 'phone',而模型没定义该字段且未设 protected $schema,MySQL 直接报 Unknown column 'phone'
  • 用了 $model->allowField(true) 但没在每次循环里重置,导致后续条目被上一条残留的 allowField 策略干扰
  • 模型启用了 $autoWriteTimestamp = true,但某条数据手动传了 'create_time' => null,MySQL 严格模式下插入失败

insertAll() 和 saveAll() 到底选哪个

核心区别不在“快慢”,而在“走不走模型逻辑”:

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

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

下载
  • insertAll() 是 Db 层方法,跳过模型验证、获取器、修改器、事件、自动时间戳,纯 SQL 批量 INSERT。适合导入清洗过的原始数据(如 Excel 解析后)、后台脚本、高吞吐场景
  • saveAll() 是模型方法,每条都实例化模型对象、触发 beforeWrite、afterWrite、检查 $readonly、执行 setAttr()。适合需要业务校验、关联处理、日志埋点的常规批量保存
  • 性能上,insertAll() 通常快 3–5 倍,但丢了模型层所有防护;saveAll() 慢,但能捕获单条失败并定位到具体哪一行哪一列
  • 别混用:用 Db::table('user')->insertAll($data) 就别指望 createTime 自动写入;用 UserModel::saveAll($data) 就别绕过模型去手动拼 SQL

批量写入时 create_time/update_time 不生效?

自动时间戳不是“全局开关”,它只在满足全部条件时才工作:

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

  • 模型中必须显式声明 protected $autoWriteTimestamp = true;(5.1/6.x 都要)
  • 数据库字段名得匹配(默认是 create_time/update_time),否则要配 protected $createTime = 'add_time';
  • 字段类型要是 DATETIME 或 TIMESTAMP;如果是 INT,还得加 protected $type = ['create_time' => 'integer'];
  • saveAll() 中每条记录都算一次独立 save(),所以每条都会写 create_time;但 update_time 只有“检测到字段值变更”才更新,不是每条都刷
  • 如果用 insertAll(),自动时间戳完全不触发 —— 它压根不进模型层

大数量导入卡死或内存爆掉怎么办

ThinkPHP 默认把整张 Excel 或 CSV 全读进内存再处理,几万行就容易 OOM。真实项目必须分片:

  • Excel 导入时,用 $spreadsheet->getActiveSheet()->getRowIterator(2) 从第 2 行开始迭代,配合 yield 或手动分批(比如每 500 行 insertAll() 一次)
  • CSV 导入别用 file_get_contents() 全读,坚持用 fopen() + fgetcsv() 流式读取,边读边入库
  • 无论哪种方式,务必手动开启事务:Db::startTrans(); try { ... insertAll(); ... } catch (\Exception $e) { Db::rollback(); throw $e; }
  • 索引很重要:批量 WHERE 更新或关联查询前,确认 id、status 等常用条件字段有数据库索引,否则 saveAll() 后续的关联更新可能锁表几十秒
字段名大小写、虚拟字段追加、验证规则动态注入这些细节,表面看是“锦上添花”,实际在线上批量场景里,往往一条数据格式不对,整批就静默丢弃或报错中断。模型层的每道闸门,都得亲手验过才敢放行。

相关文章

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

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

下载

相关标签:

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

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

WorkBuddy

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

豆包大模型

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

DeepSeek

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

切问学术

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

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

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

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

11424

2023.09.01

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

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

6601

2023.10.11

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

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

2175

2023.10.11

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

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

4188

2023.10.23

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

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

4894

2023.10.23

html怎么上传
html怎么上传

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

3831

2023.11.03

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

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

5537

2023.11.09

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

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

4342

2023.11.13

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

40

2026.10.22

热门下载

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

精品课程

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

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