PHP导入Excel前无法真正实时预览，需通过AJAX上传文件→PhpSpreadsheet解析前10行→返回JSON渲染表格；应限制读取范围、清理中文列名、校验必填字段并处理内存与编码问题。
PHP 导入 Excel 前如何用 phpspreadsheet 实时预览数据
不能直接“实时”预览——浏览器上传文件后必须先读取到服务端，再解析渲染。所谓“预览”，本质是：用户选中文件 → 通过 AJAX 上传至 PHP → PHP 用 PhpSpreadsheet 解析前几行 → 返回 JSON 给前端表格渲染。关键在控制解析范围和响应速度。
- 只读取第一页（
$reader->load($file)->getActiveSheet()），避免多 Sheet 干扰 - 限制行数（如只取前 10 行），用
$worksheet->rangeToArray('A1:Z10')，别用toArray()全量加载 - 跳过空行：遍历数组时检查
array_filter($row)是否为空，避免脏数据占位 - 前端需禁用表单默认提交，用
FormData+fetch上传，否则页面刷新就没了预览
为什么用 PhpSpreadsheet 而不是 PHPExcel 或 csv 扩展
PHPExcel 已废弃，Composer 安装会报错；原生 fgetcsv 只能处理纯 CSV，班级通信录常含合并单元格、中文表头、日期格式（如“2025-03-12”被 Excel 存为数字 45728），PhpSpreadsheet 能自动识别并转换类型。
- 日期列会转成
DateTime对象，需用\PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject($val)提取 - 中文列名（如“姓名”“电话”）可能带空格或全角符号，解析后建议用
trim()+str_replace(' ', '', $header)清理 - 若 Excel 含公式，
getCellValue()返回计算结果，getFormattedValue()返回显示值（如货币符号），通信录一般用前者
导入前校验字段是否匹配班级通信录结构
预览阶段就要判断列顺序和必填项是否存在，而不是等到正式导入才报错。比如班级通信录约定首行为 ['学号', '姓名', '性别', '手机号', '家长电话']，缺一不可。
- 提取第一行作为 header 数组，用
array_map('trim', $header)标准化 - 用
array_diff(['学号','姓名','性别'], $header)找缺失列，返回错误提示而非静默忽略 - 手机号列若含汉字（如“暂无”）、短横线或括号，可在预览时标黄提醒，但不阻止继续——校验逻辑留到正式导入环节
- 避免用
in_array('姓名', $header)粗暴匹配，应加模糊容错：如mb_stripos($h, '姓名') !== false
常见失败点：上传临时文件路径丢失、内存溢出、中文乱码
预览失败八成卡在这三处，不是代码逻辑问题，而是环境和调用姿势不对。
立即学习“PHP免费学习笔记（深入）”；
-
$_FILES['file']['tmp_name']在 PHP 脚本结束后自动删除，预览接口必须在本次请求内完成IOFactory::load()，不能存路径下次读 - 大文件（>5MB）易触发
Fatal error: Allowed memory size exhausted，在预览前加ini_set('memory_limit', '256M')，且务必用rangeToArray('A1:Z20')限定区域 - Excel 中文显示为 ，大概率是 PHP 文件本身编码非 UTF-8（特别是 Windows 下用记事本保存的 PHP 脚本），确认编辑器保存为 UTF-8 无 BOM
真正难的不是读出来，而是让用户一眼看懂哪列对不上、哪行格式异常——预览界面最好把 header 单独一行高亮，数据行 hover 显示原始单元格类型（date/string/numeric），这些细节比功能本身更影响落地效果。
