PHP读取Excel并导入数据库的教程

本文详细讲解了使用 PhpSpreadsheet 安全、稳定地将 Excel 文件（xlsx/xls）导入数据库的完整实践方案，涵盖环境配置、文件校验、逐行读取与空行跳过、动态列名映射、多类型数据清洗（邮箱、日期、数值、中文空格等）、以及基于事务的高效批量插入，直击生产环境中常见的字段错位、内存溢出、乱码、数据丢失、SQL 注入和一致性失败等痛点，为开发者提供一套开箱即用、鲁棒性强、可维护性高的 Excel 导入落地指南。

用 PhpSpreadsheet 读取 Excel 文件最稳妥

PHP 原生不支持 Excel 解析，fgetcsv() 只能处理 CSV，对 .xlsx/.xls 格式会直接报错或读出乱码。现在主流且维护活跃的库是 PhpSpreadsheet（PHPExcel 已停止更新）。它支持 xlsx、xls、ods 等格式，且无扩展依赖（纯 PHP 实现）。

安装方式：

composer require phpoffice/phpspreadsheet

注意：memory_limit 要调高（如 256M 或更高），否则大文件会触发 Fatal error: Allowed memory size exhausted；另外，避免用 $_FILES['file']['tmp_name'] 直接传给 IOFactory::load() 后不做校验——若上传的是空文件或非 Excel 类型（比如 .txt 重命名成 .xlsx），会抛出 Could not open ... for reading! File does not exist. 或更隐蔽的解析异常。

读取时跳过空行和表头，用 getActiveSheet()->getRowIterator() 控制粒度

很多人用 $worksheet->toArray() 一把梭，但该方法会把所有空白单元格转成 null 或空字符串，导致后续插入数据库时字段错位。更可控的方式是逐行遍历，手动判断是否为有效数据行。

• 先用 $spreadsheet->getActiveSheet()->getHighestRow() 获取最大行号，避免循环到几万行空行
• 从第 2 行开始遍历（假设第 1 行是表头），用 $row->getCellIterator() 遍历每列，再用 $cell->getValue() 取值
• 对每一行，用 array_filter($rowData, 'strlen') 判断是否全为空；若为空，continue
• getValue() 默认会自动类型转换（日期变时间戳、数字去零等），如需原始字符串，改用 $cell->getFormattedValue()

插入数据库前必须做字段映射和数据清洗

Excel 列名（A列/B列）和数据库字段名通常不一致，硬编码列索引（如 $rowData[0]）极易出错：用户调整 Excel 列序、多插入一列、隐藏列，都会导致数据插进错误字段。正确做法是先读取首行作为键名，构建映射关系：

$header = $worksheet->rangeToArray('A1:' . $columnLetters[$highestColumn] . '1')[0];
$columnMap = array_flip(array_map('trim', $header)); // ['用户名' => 0, '邮箱' => 1, ...]

之后每行数据按字段名提取：

$data = [
    'username' => $rowData[$columnMap['用户名']] ?? '',
    'email'    => $rowData[$columnMap['邮箱']] ?? '',
];

关键清洗动作：

• 用 filter_var($email, FILTER_VALIDATE_EMAIL) 校验邮箱格式
• 用 mb_trim()（或自定义函数）处理中文空格、全角空格、换行符
• 日期字段用 \PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject() 转标准 DateTime，再格式化为 Y-m-d H:i:s
• 数值字段用 is_numeric() + (float) 强转，避免插入字符串引发 MySQL 类型警告

批量插入要用 PDO::prepare() + execute()，别拼 SQL

逐条 INSERT 插入 1000 行 Excel 数据，可能耗时数秒甚至超时；而用单条 INSERT INTO ... VALUES (),(),() 拼接又容易触发 max_allowed_packet 错误或 SQL 注入风险（尤其当 Excel 含单引号、反斜杠）。

推荐方案：预处理语句 + 批量执行（每次 100~500 行）：

$pdo->beginTransaction();
$stmt = $pdo->prepare("INSERT INTO users (username, email, created_at) VALUES (?, ?, ?)");
foreach (array_chunk($allData, 100) as $chunk) {
    foreach ($chunk as $row) {
        $stmt->execute([$row['username'], $row['email'], $row['created_at']]);
    }
}
$pdo->commit();

注意点：

• 务必包裹在事务中，否则中途失败会导致部分写入
• 不要在循环内反复 prepare()，只准备一次
• 如果表有唯一索引，可用 INSERT IGNORE 或 ON DUPLICATE KEY UPDATE 处理重复数据，但需提前确认业务逻辑是否允许覆盖

Excel 导入真正的难点不在读取，而在字段对齐、空值/异常值容忍、事务一致性——这些地方漏掉一个检查，上线后就容易出现“看着导入成功，查数据库却少了几百条”或者“手机号全变成科学计数法”。

本篇关于《PHP读取Excel并导入数据库的教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！