PHP批量导入CSV到MySQL应采用fgetcsv()逐行读取配合多值INSERT语句,兼顾性能与可控性;避免单条循环插入和LOAD DATA INFILE(权限、路径、编码、调试等限制),需注意UTF-8无BOM编码、分隔符设置、字段类型匹配及小数据量先行验证。

PHP 读取 CSV 文件并批量插入 MySQL 的核心逻辑
直接用 fgetcsv() 逐行读取 + INSERT INTO ... VALUES (),(),() 多值批量插入,是性能和可控性兼顾的方案。别用单条 INSERT 循环,万级数据会慢到超时或内存溢出。
为什么不能直接用 LOAD DATA INFILE
虽然它最快,但多数共享主机禁用该命令;即使有权限,也要求 CSV 文件在数据库服务器本地(不是 PHP 所在机器),且需处理字段转义、编码、行结束符等细节,出错难调试。对日常导入场景,主动控制更稳妥。
-
LOAD DATA INFILE需要 MySQL 的FILE权限,线上环境通常不开放 - CSV 路径必须是 MySQL 服务端可访问路径,
$_FILES['file']['tmp_name']上传临时文件不满足条件 - 遇到中文乱码、引号嵌套、换行符在字段内等情况,
LOAD DATA容易报错中断,且无明确错误行提示
实际可用的 PHP 批量导入代码(含防错)
关键点:设置好字符集、限制单次批量数量(如 1000 行)、跳过表头、过滤空行、转义特殊字符。以下示例使用原生 MySQLi(非 PDO),避免预处理语句在批量场景下的开销。
多瑞外贸网店系统立足于全球化贸易往来的一款外贸类企业用户高端应用电子商务系统软件,帮助企业快速搭建网聚全球商机的电子商务系统。本系统使用纯正的英文,国外用户更容易阅读;多年专业外贸设计经验,熟练掌握美式英语,更符合国外用户考虑和解决问题的逻辑;设计风格、用户体验符合国外用户的习惯;简洁明了的设计风格正是欧美用户的所爱,时时推出新模板、紧跟时尚潮流,供您选择。新增加淘宝数据自动导入,批量上传商品,商
$file = $_FILES['csv_file']['tmp_name'];
$handle = fopen($file, 'r');
if (!$handle) {
die('无法打开 CSV 文件');
}
// 假设表结构为 users(id, name, email, created_at)
$values = [];
$batchSize = 1000;
$rowCount = 0;
$headerSkipped = false;
while (($row = fgetcsv($handle)) !== false) {
if (!$headerSkipped) {
$headerSkipped = true;
continue; // 跳过第一行表头
}
if (empty(array_filter($row))) continue; // 跳过全空行
$id = intval($row[0]);
$name = mysqli_real_escape_string($mysqli, trim($row[1]));
$email = mysqli_real_escape_string($mysqli, trim($row[2]));
$created_at = date('Y-m-d H:i:s');
$values[] = "($id, '$name', '$email', '$created_at')";
if (count($values) >= $batchSize) {
$sql = "INSERT INTO users (id, name, email, created_at) VALUES " . implode(',', $values);
if (!mysqli_query($mysqli, $sql)) {
die('批量插入失败: ' . mysqli_error($mysqli));
}
$values = [];
$rowCount += $batchSize;
}
}
// 插入剩余不足 batch 的数据
if (!empty($values)) {
$sql = "INSERT INTO users (id, name, email, created_at) VALUES " . implode(',', $values);
mysqli_query($mysqli, $sql);
$rowCount += count($values);
}
fclose($handle);
echo "成功导入 $rowCount 条记录";
容易被忽略的三个坑
导入失败往往不出错信息,但数据不对——问题多藏在这些地方:
立即学习“PHP免费学习笔记(深入)”;
- CSV 文件编码必须是
UTF-8 无 BOM,否则中文变问号;用编辑器(如 VS Code)另存时确认编码选项 -
fgetcsv()默认以逗号分隔,若原始 CSV 用分号或制表符,需显式传参:fgetcsv($handle, 0, ';') - MySQL 字段类型不匹配:比如 CSV 中某列为
"123.45",但数据库字段是INT,插入时会被截断为123,且无警告










