应逐行读取Excel跳过表头，trim后精确匹配目标班级名，通过表头定位列索引，插入前校验班级外键存在性，CSV需处理BOM与编码，全程事务控制并标记错误行。
PHP 导入 Excel 时如何按 班级 字段筛选并只处理指定班级数据
直接在读取阶段就过滤，比全量导入再 WHERE 查询更省内存、更安全。用 PhpSpreadsheet 时，别急着把整张表 toArray()，先逐行读取判断 班级 列值是否匹配目标班级名。
常见错误是：Excel 第一行是表头，但代码从第 1 行开始遍历（实际应跳过第 1 行），或没 trim 班级字段导致空格比对失败（如 “高一(3)班” vs “高一(3)班 ”）。
- 用
$worksheet->getRowIterator(2)跳过表头（假设第 1 行是标题） - 每行用
$cell->getValue()取班级单元格（例如第 2 列，即'B'列），然后trim((string)$value) === $targetClass - 确保 Excel 中班级列没有合并单元格——合并单元格会导致后续行读取错位
- 若班级字段在不同 Excel 版本中列序不固定（比如有时是 B 列，有时是 D 列），先通过表头行定位列索引：
array_search('班级', $headerRow)
MySQL 插入前必须校验 班级 字段是否存在对应班级记录
不能默认“Excel 里写了就代表班级合法”。实际业务中，班级 通常来自独立的 class 表，学生记录需关联 class_id 外键。直接插字符串班级名会违反约束或埋下脏数据。
典型报错：SQLSTATE[HY000]: General error: 1452 Cannot add or update a child row，就是外键不匹配。
立即学习“PHP免费学习笔记（深入）”；
- 提前查一次：
SELECT id FROM class WHERE name = ?，绑定$targetClass，获取$classId - 查不到就中断导入，返回具体提示：“班级「XXX」未在系统中创建，请先维护班级基础信息”
- 插入学生记录时，用
$classId而非原始 Excel 中的班级字符串 - 批量插入时，所有记录共用同一个
$classId，别在循环里重复查库
用 fgetcsv() 读取 CSV 更轻量，但要注意中文和 BOM 头
如果上传的是 CSV（不是 Excel），PhpSpreadsheet 就有点重了。fgetcsv() 足够快且内存友好，但 Windows 下 Excel 另存为 CSV 默认带 UTF-8 BOM，会导致第一列字段名开头多出乱码（如 "\xEF\xBB\xBF班级"），进而使 array_search 失败。
- 读取前先用
file_get_contents($file)检查前 3 字节是否为\xEF\xBB\xBF，是则用substr($content, 3)剥离 BOM 再写回临时文件 - 用
mb_detect_encoding()验证编码，避免 GBK 文件被当 UTF-8 解析导致中文乱码 - 设置
fgetcsv()的第三个参数为','，第四个为"\""，第五个为"\n"，显式声明分隔符/包裹符/换行符，防止字段含逗号或换行导致解析错行 - CSV 没有“工作表”概念，无需处理多 sheet，但也意味着无法靠 sheet 名隐式指定班级
导入过程必须加事务 + 错误行标记，不能“成功一半”
哪怕只有一条记录班级不匹配或手机号格式错误，整个导入也应回滚，否则数据状态不一致。同时要告诉用户哪几行出了问题，而不是只报“导入失败”。
- 用
$pdo->beginTransaction()包裹全部插入逻辑 - 循环中每条记录单独 try/catch，捕获异常后记录错误行号和原因（如“第 15 行：班级字段为空”），继续处理下一行（不要 break）
- 全部跑完再统一判断：如有错误行，
$pdo->rollback()；否则$pdo->commit() - 返回结构建议：
['success' => 23, 'failed' => [['row' => 15, 'reason' => '班级不存在']], 'class_id' => 42] - 别在事务里做耗时操作（如发邮件、调远程 API），会拖长锁表时间
