PHP实现“导入即导出”需服务端直接解析$_FILES临时文件并生成Excel流式下载，避免落盘；通过表头模糊匹配、空值容错、UTF-8文件名兼容处理及结构化JSON错误反馈保障鲁棒性。
导入 Excel 后立即生成通信录导出文件，不依赖前端二次点击
PHP 实现“导入即导出”本质是服务端完成两件事：解析上传的 $_FILES 文件，再用解析结果生成新 Excel 并强制下载。关键不是串联两个操作，而是避免中间落盘、减少 IO 延迟和临时文件残留。
常见错误是先 move_uploaded_file 到临时目录，再用 PhpSpreadsheet 读取，最后又写入新文件——这多了一次磁盘读写，且并发时容易冲突。
- 直接用
fopen($_FILES['file']['tmp_name'], 'r')获取资源句柄传给IOFactory::load()，跳过保存 - 导出阶段别用
header('Location: ...')跳转，而应设置完整响应头后直接输出二进制流 - 务必在
ob_end_clean()后输出，否则 BOM 或空白字符会导致 Excel 打开报错
用 PhpSpreadsheet 处理班级通信录字段映射与空值容错
班级通信录通常含姓名、学号、电话、家长姓名、关系、班级等字段，Excel 表头可能不规范（如“联系电话”“手机”混用），且常有空行或合并单元格。
不能直接按列索引硬编码读取，得做表头识别：
立即学习“PHP免费学习笔记（深入）”；
- 读取第一行，用
array_map('trim', $headerRow)清洗空格 - 建立映射数组：
$map = ['姓名' => 'name', '学号' => 'student_id', '电话' => 'phone']，再遍历匹配最接近的键（可用levenshtein粗筛） - 对每行数据，用
$cell->getFormattedValue()而非getValue()，避免日期变成数字（如 44562 → 2022-01-01） - 空单元格默认设为
null，但导出时需转成空字符串，否则setCellValue()可能报错
导出文件名含班级名称和时间戳，避免中文乱码与浏览器兼容问题
文件名带班级名（如“高三（2）班通信录.xlsx”）时，Chrome 和 Edge 支持 UTF-8 原生，但 Safari 和旧版 IE 需要 rawurlencode() + mb_convert_encoding() 双重处理。
- 推荐方案：
$filename = 'class_contact_' . date('Ymd_His') . '.xlsx';（纯 ASCII），再在响应头里补充X-Content-Name自定义字段供前端显示中文名 - 必须设置：
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'); -
Content-Disposition中的filename=用 ASCII，filename*=用 UTF-8 编码：filename*=UTF-8''%E9%AB%98%E4%B8%89%EF%BC%88%32%EF%BC%89%E7%8F%AD.xlsx
导入失败时返回结构化 JSON，而不是直接 die() 或 echo 错误信息
前端需要知道哪一行、哪个字段出错（比如第 5 行“电话”格式非法），以便高亮提示。直接 echo "第5行电话为空" 会破坏 Excel 二进制输出流，导致文件损坏。
- 所有校验逻辑放在导入解析阶段，收集错误到数组：
$errors[] = ['row' => 5, 'field' => 'phone', 'message' => '手机号长度不足11位']; - 若
count($errors) > 0，立刻header('Content-Type: application/json');并exit(json_encode(['status' => 'error', 'errors' => $errors])); - 只有无错误时才走导出流程；导出异常（如内存不足）也应捕获
PhpSpreadsheet\Exception，统一返回 JSON
真正的难点不在代码量，而在字段语义识别的鲁棒性——比如“父姓名”“父亲姓名”“爸爸姓名”都要归到 father_name，这个没法靠正则穷举，得结合业务词典+模糊匹配，上线后还得持续收用户反馈迭代。
