PHP批量导入班级通信录需规范文件格式、编码转换、空行跳过、键值映射、PDO预处理+事务、分批执行、数据校验、错误明细记录及大文件防护。
PHP批量导入班级通信录前，先确认Excel或CSV格式是否规范
直接用 fgetcsv() 或 PhpSpreadsheet 读取文件时，如果首行不是标准字段名（如 name、student_id、phone），后续映射必然出错。更常见的是 Excel 里混入空行、合并单元格、中文乱码（ANSI 编码未转 UTF-8）——这些都会导致某条数据解析失败却静默跳过。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 强制要求上传
.csv文件，并在前端提示“请用 Excel 另存为 CSV UTF-8 格式” - 用
mb_detect_encoding()检查文件编码，非UTF-8时用iconv('GB2312', 'UTF-8//IGNORE', $line)转换 - 跳过空行：读取每行后用
array_filter($row, 'strlen')判断是否全为空值 - 字段映射不要硬编码索引（如
$row[0]），改用表头行建立键值映射：$header = array_map('trim', $first_row); $data = array_combine($header, $row);
用PDO预处理+事务实现安全批量插入
逐条 INSERT 插入几百条学生记录，可能耗时数秒且容易超时；而拼接大 SQL 字符串又面临 SQL 注入和长度限制（如 MySQL max_allowed_packet 默认 4MB）。正确做法是用 PDO 的预处理语句配合事务提交。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 开启事务：
$pdo->beginTransaction()，全部成功再commit()，任一失败则rollback() - 复用同一预处理语句：
$stmt = $pdo->prepare("INSERT INTO contact (name, student_id, phone) VALUES (?, ?, ?)")，循环中只调用$stmt->execute([$name, $sid, $phone]) - 每 100 条执行一次
execute()并清空参数缓存（避免内存累积），不攒几千条再统一 execute —— PDO 不会自动批处理 - 插入前加简单校验：
if (empty($data['student_id']) || !is_numeric($data['student_id'])) { continue; }，跳过脏数据并记日志
导入结果要区分“成功数”“失败行号”“错误原因”
用户传了 500 行数据，只返回“成功导入 482 条”，等于没说清楚哪 18 条丢了、为什么丢。实际维护中，班主任最需要的是可定位的失败详情。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 维护两个数组：
$success_list存插入成功的学号，$error_list存['row' => 45, 'reason' => '手机号格式错误'] - 对
phone字段做基础过滤：preg_replace('/[^0-9+]/', '', $phone)，但别直接删掉带括号或横杠的合法号码（如0755-12345678），应先尝试标准化再校验 - 数据库唯一约束冲突（如重复学号）捕获
SQLSTATE 23000错误，而不是让整个事务回滚——可用INSERT ... ON DUPLICATE KEY UPDATE或先SELECT查重 - 最终返回 JSON：
['total' => 500, 'success' => 482, 'errors' => [...]]，前端渲染成表格供下载错误明细
避免上传大文件导致超时或内存溢出
班级通信录一般不大，但若允许上传整个年级 Excel（上万行），$_FILES['file']['tmp_name'] 加载进内存解析极易触发 memory_limit 或 max_execution_time 限制。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 服务端校验
$_FILES['file']['size']，超过 2MB 直接拒绝，不进入解析逻辑 - 用
PhpSpreadsheet/Reader/Xlsx时启用setReadDataOnly(true)，跳过样式、公式等无用信息 - 对 CSV 使用流式读取：
$handle = fopen($tmp_file, 'r'); while (($row = fgetcsv($handle)) !== false) { ... }，不一次性file_get_contents - Apache 下设置
LimitRequestBody 2097152，Nginx 下配client_max_body_size 2M，从入口层拦截超大请求
实际批量导入的难点不在语法，而在如何让失败可追溯、大文件不崩、脏数据不卡死——这些细节没处理好，页面上一个“导入完成”按钮点下去，后台可能静默丢掉二十条记录，还查不出原因。