PHP批量导入CSV到数据库教程

本文详解了PHP批量导入CSV数据到MySQL数据库的高效且稳妥实践方案，推荐使用fgetcsv()逐行读取配合多值INSERT语句（如INSERT INTO ... VALUES (),(),()）实现性能与可控性的最佳平衡，明确避开单条循环插入的低效陷阱和LOAD DATA INFILE在权限、路径、编码及调试方面的诸多限制；同时强调UTF-8无BOM编码、分隔符适配、字段类型匹配等关键细节，并提供可直接运行的防错代码示例——从跳过表头、过滤空行、转义特殊字符到分批提交（如每1000行一插），辅以小数据量先行验证的落地建议，助你一次跑通真实业务场景中的CSV导入需求。

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 条记录";

容易被忽略的三个坑

导入失败往往不出错信息，但数据不对——问题多藏在这些地方：

• CSV 文件编码必须是 UTF-8 无 BOM，否则中文变问号；用编辑器（如 VS Code）另存时确认编码选项
• fgetcsv() 默认以逗号分隔，若原始 CSV 用分号或制表符，需显式传参：fgetcsv($handle, 0, ';')
• MySQL 字段类型不匹配：比如 CSV 中某列为 "123.45"，但数据库字段是 INT，插入时会被截断为 123，且无警告

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

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《PHP批量导入CSV到数据库教程》文章吧，也可关注golang学习网公众号了解相关技术文章。