PHP导入Excel到通信录教程步骤详解

本文详解了使用PHP安全高效地将Excel文件导入通信录系统的完整实践方案，强调必须采用已维护的PhpSpreadsheet替代废弃的PHPExcel，并深入讲解了表头显式映射、空格与全角字符清洗、字段格式校验（如手机号去杂符、学号强制文本）、分批处理大文件以避免内存溢出和超时、事务控制与错误精准记录等关键细节，直击生产环境中Excel导入易出错、难追溯、不可控的痛点，为开发者提供一套开箱即用、健壮可维护的落地指南。

PHP 读取 Excel 文件必须用 PhpSpreadsheet，别碰 PHPExcel

旧版 PHPExcel 已停止维护，composer 安装会失败或报 Class 'PHPExcel_IOFactory' not found。现在唯一靠谱的选择是 PhpSpreadsheet（phpoffice/phpspreadsheet），它兼容 PHP 7.2+，支持 .xlsx、.xls、.csv，且内存占用更可控。

安装命令：

composer require phpoffice/phpspreadsheet

• 如果项目没用 Composer，别手动下载源码——自动加载和依赖管理会出问题
• Windows 下若提示 zip extension is not loaded，需在 php.ini 中启用 extension=zip
• PhpSpreadsheet 默认不读取单元格样式/公式结果，只读值；如需显示公式计算后的值（比如“=A1+B1”显示为数字），得用 $cell->getCalculatedValue()，但性能会下降

导入 Excel 时字段映射必须显式定义，不能靠表头顺序硬编码

班级通信录常见字段如：学号、姓名、性别、手机号、家长电话、家庭住址。Excel 表头可能写成“学生姓名”“联系电话（家长）”甚至中英文混用，直接按列索引（$row[0], $row[1]）极易错位。

正确做法是先读第一行作为键名，再用 array_combine() 构建关联数组：

$header = $worksheet->rangeToArray('A1:'.$worksheet-&gt>getHighestColumn().'1')[0];
$dataRows = $worksheet->rangeToArray('A2:'.$worksheet->getHighestColumn().$worksheet->getHighestRow());
foreach ($dataRows as $row) {
    $record = array_combine($header, $row);
    // 后续插入数据库时用 $record['姓名']、$record['手机号'] 等
}

• 注意：Excel 表头若有空格或全角字符（如“姓名　”），会导致键名不匹配，建议用 trim() 和 str_replace() 清洗
• 如果 Excel 多个 sheet，需用 $spreadsheet->getSheetByName('名单') 指定，别默认用第一个
• 空行会被读成全 null 的数组，插入前要加 array_filter($row, 'strlen') 过滤

批量插入通信录数据前，务必做字段校验和去重，否则脏数据直接进库

Excel 导入最常踩的坑不是读取失败，而是把“张三”输成“张 三”、手机号带空格、“男 ”多一个空格、学号填成文本格式导致后续查询失效。

• 手机号统一用 preg_replace('/\D/', '', $phone) 去除非数字字符，再判断长度是否为 11
• 学号若为纯数字但 Excel 自动转成科学计数法（如 123456789012 显示为 1.23457E+11），需在读取时强制设为字符串：$cell->getStyle()->getNumberFormat()->setFormatCode(\PhpOffice\PhpSpreadsheet\Style\NumberFormat::FORMAT_TEXT)
• 用 INSERT IGNORE INTO 或先 SELECT COUNT(*) WHERE stu_id = ? 防止重复导入同一学生
• 错误行要记录行号和原因（如“第5行：手机号格式错误”），不能只抛异常中断整个导入

大文件（>5MB 或 >1000 行）导入必须分批 + 设置超时，否则 504 或内存溢出

默认 PHP 配置扛不住整表一次性载入，PhpSpreadsheet 加载 1000 行 xlsx 就可能吃掉 128MB 内存。线上环境必须控制节奏。

• 用 $worksheet->getRowIterator($startRow, $endRow) 分段读取，比如每 200 行一批
• 每批处理完调用 gc_collect_cycles() 主动触发垃圾回收
• CLI 模式下加 set_time_limit(0)；Web 模式下改 Nginx fastcgi_read_timeout 和 PHP max_execution_time
• 别在循环里反复 new PDO 实例，复用连接，用 beginTransaction() + commit() 包裹整批插入

真正难的不是读 Excel，是让导入过程可中断、可追溯、可回滚。比如记录已处理行号到临时表，下次断点续传；或者生成导入日志文件供人工核查。这些细节，比选哪个库重要得多。

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