PHP使用PhpSpreadsheet导入Excel时空行被插入数据库的问题
解决Excel导入时空行被写入数据库的修改方案
问题根因
当前代码调用toArray()读取表格内容时,默认会把工作表范围内所有行(哪怕单元格完全没有输入内容)都返回为数组项,原逻辑没有对这些无内容的空行做校验,直接执行了数据库插入,最终生成多余的空记录。
具体修改方式
1. 读取阶段直接过滤空行(性能最优)
在获取表格数据时,通过PhpSpreadsheet的内置配置跳过空单元格,从源头减少无效循环数据,直接修改原来获取$data的代码段:
原代码:
$data = $spreadsheet->getActiveSheet()->toArray();
替换为带空值过滤的代码:
$sheet = $spreadsheet->getActiveSheet(); // 关闭空单元格读取,不把无内容的单元格纳入返回数组 $sheet->setReadEmptyCells(false); $data = $sheet->toArray(); // 过滤掉数组中完全没有有效内容的行 $data = array_filter($data, function($row) { // 统计当前行里去除前后空白后还有实际内容的单元格数量 $validCellCount = count(array_filter($row, function($cell) { return trim((string)$cell) !== ''; })); // 有有效单元格的行就保留,全空就移除 return $validCellCount > 0; });
2. 循环插入前加行级校验(改动最小)
如果不想调整PhpSpreadsheet的读取配置,就在原有循环逻辑里,准备插入数据前加空行判断,找到代码里if($isheader > 0)的分支,在最开头新增跳过逻辑:
foreach($data as $row) { if($isheader > 0) { // 新增空行校验:以*核心必填字段*(第一列name)为判断依据 if (trim((string)($row[0] ?? '')) === '') { // 当前行核心字段为空,跳过本次循环不执行插入 continue; } // 以下原有插入逻辑完全不变 $insert_data = array( ':name' => $row[0], ':slug'=>slugGenerator($row[0]), ':city' => $row[1], ':size' => $row[2], ':about' => $row[3], ':email' => $row[4], ':meta_keyword' => $row[5], ':meta_desc' => $row[6], ':page_title' => $row[7], ); $query = "INSERT INTO `list`(`name`, `slug`, `city`, `size`, `about`, `email`, `meta_keyword`, `meta_desc`,`page_title`) VALUES (:name,:slug,:city,:size,:about,:email,:meta_keyword,:meta_desc,:page_title)"; $statement = $pdo->prepare($query); $statement->execute($insert_data); } else { $isheader = 1; } }
这里的判断逻辑可以根据业务要求调整,如果需要更严格的校验,可以把核心字段判断换成整行有效单元格校验,和第一种方法里的判断逻辑保持一致。
可选优化
- 把
prepare的SQL语句移到循环外,避免每次循环重复编译SQL,提升大文件导入的速度。 - 导入逻辑包裹数据库事务,避免导入中途出错产生不完整的写入记录。
内容的提问来源于stack exchange,提问作者user9437856
相关产品推荐
相关产品推荐

