php实现班级通信录导入导出联动_php导入后自动导出法【步骤】

PH

P实现“导入即导出”需服务端直接解析$_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 表头可能不规范（如“联系电话”“手机”混用），且常有空行或合并单元格。

不能直接按列索引硬编码读取，得做表头识别：

• 读取第一行，用 array_map('trim', $headerRow) 清洗空格
• 建立映射数组：$map = ['姓名' => 'name', '学号' => 'student_id', '电话' => 'phone']，再遍历匹配最接近的键（可用 levenshtein 粗筛）
• 对每行数据，用 $cell->getFormattedValue() 而非 getValue()，避免日期变成数字（如 44562 → 2025-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，这个没法靠正则穷举，得结合业务词典+模糊匹配，上线后还得持续收用户反馈迭代。