ThinkPHP5.1.41批量添加数据教程-ThinkPHP-PHP中文网

thinkphp5.1.41批量添加数据必须用db::insertall()或模型saveall()，禁用循环+save()；前者最稳、一次sql、无验证开销，后者支持事件与验证但性能略低；超500条须分片（如array_chunk($data, 500)）、关闭调试、预处理脏数据。

thinkphp5.1.41批量添加数据教程

直接说结论：ThinkPHP5.1.41批量添加数据，别用循环+save()，必须用Db::insertAll()或模型的saveAll()，否则单条插入在500条数据时可能超时、锁表、触发MySQL max_allowed_packet、甚至被WAF拦截。核心是「一次拼SQL」而非「N次请求数据库」。

Db::insertAll() 是最稳的批量写入方式

这是TP5.1原生查询类提供的专用方法，底层调用INSERT INTO ... VALUES (),(),() 语法，只发一次SQL请求。

常见错误现象：用foreach遍历数组，每轮调用Db::table()->insert($item)，100条数据就发100次SQL——线上环境基本会卡死或报MySQL server has gone away。

实操建议：

确保数据是二维关联数组，键名必须与数据库字段完全一致（大小写敏感）
单次插入不宜超过1000条，否则可能触发max_allowed_packet（默认4M，1000条含中文的记录约2–3MB）
插入前建议用array_map('htmlspecialchars_decode', $data)预处理，防富文本中HTML实体干扰
返回值是影响行数（int），不是布尔值；失败时抛出think\db\exception\DataNotFoundException异常

示例：

$data = [
    ['name' => '张三', 'email' => 'z3@example.com', 'create_time' => time()],
    ['name' => '李四', 'email' => 'l4@example.com', 'create_time' => time()],
];
$result = Db::name('user')->insertAll($data);
if (false === $result) {
    // 插入失败，检查 $result->getError()
}

模型saveAll()适合带事件/验证的场景

当你需要触发模型的before_insert、自动完成、验证规则（如require、email格式）、或者软删除字段自动填充时，用模型层更安全。

但注意：它内部仍是调用insertAll()，只是多了一层处理。性能略低，但业务逻辑完整性高。

容易踩的坑：

btpanel phpsite 宝塔面板PHP网站

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

下载

必须用new User()实例化模型，不能用User::create()——后者只支持单条
数据里不能含主键（如id），否则TP会当作更新操作， silently 跳过
验证失败时，saveAll()返回false，但不会告诉你哪一行错；需配合User::getError()看最后一条的错误信息
不支持事务自动包裹，如需回滚，得手动Db::startTrans() + try/catch

示例：

$user = new User();
$data = [['name'=>'王五','email'=>'w5@example.com'], ['name'=>'赵六','email'=>'z6@example.com']];
$result = $user->saveAll($data);
if (false === $result) {
    echo $user->getError(); // 只显示最后一条的验证错误
}

大数量导入必须分片 + 关闭调试 + 预处理

超过2000条数据时，即使insertAll()也容易因PHP内存限制（memory_limit）或MySQL超时（wait_timeout）中断。

正确做法是切片 + 环境调优：

用array_chunk($data, 500)分批，每批单独insertAll()
导入前临时关闭调试：Config::set('app_debug', false)，避免日志写入拖慢速度
禁用SQL日志记录：Db::listen(function(){})清空监听器，或配置'sql_explain' => false
确认MySQL的innodb_buffer_pool_size足够（建议≥1G），否则大批量插入会频繁刷盘

特别注意：不要在事务里包所有分片——锁表时间太长；应在每个分片内独立事务，或干脆不用事务（依赖业务容错）。

Excel导入后批量写入的典型链路

你从PHPExcel读出$excel_array后，不能直接扔给insertAll()——它通常含表头、空行、类型错乱（日期变数字、数字变科学计数）。

关键处理点：

用unset($excel_array[0])删首行（表头），再用array_values()重排键
Excel日期列（如$value[2]）要转为时间戳：($value[2] - 25569) * 86400，再date('Y-m-d H:i:s', $ts)
空字符串''要转为null（尤其对应数据库允许NULL的字段），否则MySQL报Data truncated for column
字段映射必须显式做，别依赖顺序——['username'=>$v[0], 'email'=>$v[1]]比[$v[0],$v[1]]可靠得多