php批量插入需用预处理语句拼接多值占位符，严格匹配字段顺序与参数数量，分段控制在500–2000行并显式事务管理，避免sql注入与max_allowed_packet超限。
PHP 批量插入数组数据用 INSERT INTO ... VALUES (...), (...), ...
单条 INSERT 一次插一条太慢，批量插入核心就是把多条记录拼成一个 SQL 语句。PHP 本身没有内置“批量插入函数”，得自己组装 SQL 和参数——但别手拼字符串，容易 SQL 注入。
关键原则：值部分用占位符（? 或命名占位符），再用 execute() 绑定数组，由 PDO/MySQLi 自动转义。
- 用
PDO::prepare()+PDOStatement::execute()最安全 - 避免用
implode(', ', $array)直接拼值——字符串字段没引号、NULL 不处理、类型错乱全靠运气 - 所有字段名必须提前确认，不能从用户数组动态推导（防列注入）
PDO 批量插入示例：带预处理和参数绑定
假设你要插用户数据，每条是 ['name' => '张三', 'age' => 25, 'email' => 'z3@example.com'] 这样的关联数组，共 100 条：
$pdo = new PDO($dsn, $user, $pass);
$users = [
['name' => '张三', 'age' => 25, 'email' => 'z3@example.com'],
['name' => '李四', 'age' => 30, 'email' => 'l4@example.com'],
// ... 更多
];
<p>// 提前定义字段顺序，确保和 VALUES 占位符一致
$fields = ['name', 'age', 'email'];
$placeholders = str_repeat('(?, ?, ?), ', count($users) - 1) . '(?, ?, ?)';
$sql = "INSERT INTO users (" . implode(', ', $fields) . ") VALUES $placeholders";
$stmt = $pdo->prepare($sql);</p><p>// 展平为一维数值索引数组：['张三', 25, 'z3@...', '李四', 30, 'l4@...']
$values = [];
foreach ($users as $row) {
foreach ($fields as $f) {
$values[] = $row[$f] ?? null; // 注意：null 要显式处理，避免 undefined index
}
}</p><p>$stmt->execute($values);立即学习“PHP免费学习笔记（深入）”；
注意：$placeholders 必须按行数生成对应数量的括号组，不能写死；$values 必须严格按字段顺序展平，不能用 array_values($row) 替代——键顺序不可靠。
遇到 SQLSTATE[HY093]: Invalid parameter number 怎么办
这是占位符数量和 execute() 传入数组长度不匹配的典型报错。常见原因：
-
$placeholders拼错了，比如少了一组(?, ?, ?) -
$values里漏了某个字段（比如某条数据缺email，又没设默认值或?? null） - 用了命名占位符（如
:name）但没用execute($assoc_array)，反而传了索引数组 - 字段含
created_at等自动填充列，但 SQL 里没排除，导致占位符多于实际数据
调试建议：打印 count($values) 和 substr_count($sql, '?')，两者必须相等。
大批量（万级以上）插入要分段，别一次性塞几万条
MySQL 默认 max_allowed_packet 通常 4MB–64MB，超了直接报 Packets larger than max_allowed_packet。而且事务太大易锁表、OOM、回滚代价高。
- 单次批量控制在 500–2000 行较稳妥（视单行大小而定）
- 用
array_chunk($users, 1000)切分，循环执行 - 显式开启事务：
$pdo->beginTransaction()+$pdo->commit()，否则每条execute()都是独立事务，更慢 - 如果表有唯一索引，且允许忽略重复，可用
INSERT IGNORE或ON DUPLICATE KEY UPDATE，但注意后者会触发更新逻辑
真正卡住的往往不是语法，而是没意识到 MySQL 的包限制和事务粒度——写完记得查 SHOW VARIABLES LIKE 'max_allowed_packet';。
