thinkphp 5.1 的 insertall 方法支持二维关联数组批量插入，要求字段名统一且真实存在；推荐通过模型调用，支持事务优化，但不返回自增id、不支持on duplicate key update。
ThinkPHP 5.1 的 insertAll 方法是批量插入数据的高效方式，相比循环调用 insert，它能显著减少数据库交互次数，提升性能。
确认数据格式是否符合 insertAll 要求
insertAll 接收的是二维数组（即多个记录组成的数组），每条记录是一个关联数组，键名为字段名，值为对应数据。必须确保所有子数组的键名一致，且字段名真实存在于数据表中。
- ✅ 正确示例：
$data = [
['name' => '张三', 'age' => 25, 'status' => 1],
['name' => '李四', 'age' => 30, 'status' => 1],
['name' => '王五', 'age' => 28, 'status' => 0]
];
- ❌ 错误示例（键不统一或缺失）：
$data = [
['name' => '张三', 'age' => 25],
['username' => '李四', 'age' => 30], // 字段名不一致
['name' => '王五'] // 缺少 age，可能触发 SQL 错误或默认值填充
];
在模型或查询构造器中调用 insertAll
推荐在模型类中使用，自动绑定表名和类型验证；也可直接用 Db 类操作，更灵活但需手动处理安全问题。
- 通过模型调用（推荐）：
$userModel = new UserModel(); $result = $userModel->insertAll($data); // 返回插入成功的记录数
- 通过 Db 类调用（无需模型）：
use think\Db;
$result = Db::name('user')->insertAll($data);
注意：insertAll 默认不返回自增 ID 列表，如需获取，需配合事务 + getLastInsID 手动估算，或改用原生 SQL + INSERT ... VALUES (),(),() 形式。
处理主键冲突与重复插入
ThinkPHP 5.1 的 insertAll 本身不支持 ON DUPLICATE KEY UPDATE 或 REPLACE INTO 语法。如需忽略重复、更新冲突或替换记录，需自行拼接 SQL 或使用 Db::execute：
- 忽略重复（MySQL）：
$sql = "INSERT IGNORE INTO `think_user` (`name`, `age`, `status`) VALUES ";
$values = [];
foreach ($data as $item) {
$values[] = "('" . addslashes($item['name']) . "', {$item['age']}, {$item['status']})";
}
$sql .= implode(',', $values);
Db::execute($sql);
⚠️ 手写 SQL 时务必对字符串做转义（如用 addslashes 或 Db::quote），或改用参数绑定防止注入。
性能优化与注意事项
- 单次插入不宜过多（建议 ≤ 1000 条），避免超长 SQL 或内存溢出；
- 大数据量插入前可关闭自动提交，用事务包裹提升效率：
Db::startTrans();
try {
Db::name('user')->insertAll($data);
Db::commit();
} catch (\Exception $e) {
Db::rollback();
throw $e;
}
- 如果表有大量索引或触发器，批量插入会变慢，可考虑临时禁用索引（生产环境慎用）；
-
insertAll不会触发模型的save钩子（如before_insert），如需统一处理逻辑，建议封装成模型方法并手动遍历调用save，或改用allowField+saveAll（但性能略低）。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
