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

亲爱的编程学习爱好者，如果你点开了这篇文章，说明你对《PHP读取Excel并导入数据库的完整步骤》很感兴趣。本篇文章就来给大家详细解析一下，主要介绍一下，希望所有认真读完的童鞋们，都有实质性的提高。

最稳妥方式是用 PhpSpreadsheet 逐行读取、校验文件类型、跳过空行与表头、构建列名映射、清洗数据（邮箱/日期/数值）、事务内批量插入。

用 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学习网公众号！