php新增数据怎么批量导入_csv文件数据导入数据库代码【解答】

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,且无警告
实际跑通的关键,是先拿 10 行小 CSV 测通路,再扩量。字段映射、空值处理、时间格式转换这些,得按你自己的表结构现场补全,没法靠模板一劳永逸。