PHP导入多Excel班级通信录需先统一表头结构再合并：强制按student_id、name等预设字段映射，跳过不匹配列；以student_id为键去重覆盖，保留前导零；分文件事务批量入库，控制单次500行并及时释放内存。
PHP 处理多 Excel 文件导入班级通信录的常见卡点
直接用 fgetcsv 或 PhpSpreadsheet 逐个读取再 array_merge，大概率会丢数据或字段错位——因为每个文件的表头顺序、空行位置、编码（如 GBK vs UTF-8）、甚至列数都可能不一致。必须先统一结构，再合并。
用 PhpSpreadsheet 统一读取并校验表头
别依赖用户上传的 Excel 表头顺序，强制按预设字段映射。比如班级通信录固定需要：student_id、name、phone、parent_name，其他列忽略。
- 用
PhpSpreadsheet\Reader\Xlsx或Xls分别加载每个文件，避免用IOFactory::load()自动识别（容易误判） - 读取第一行，用
$worksheet->rangeToArray('A1:Z1')[0]获取原始表头，再做array_map('trim', ...)去空格 - 通过
array_search(strtolower($header), $expected_headers)匹配字段，找不到就跳过该列；严格区分大小写或中文会导致映射失败 - 跳过空行和明显非数据行（如含“合计”“总计”等关键词的行）
合并前去重与冲突处理
多个文件可能含重复学号，不能简单追加。以 student_id 为主键做合并：
- 用
student_id作数组键：$merged[$row['student_id']] = $row; - 后读取的文件覆盖同
student_id的旧数据（默认策略），若需保留首次出现的数据，加判断if (!isset($merged[$id])) { ... } - 记录冲突日志：用
error_log("duplicate student_id {$id} in {$filename}")写入日志，方便回溯 - 注意
student_id可能是数字字符串（如 '00123'），PHP 默认转成整型会丢前导零，读取时用$cell->getValueExplicit()强制取原始字符串
批量导入前的内存与超时控制
一次读 10 个 5MB 的 Excel，很容易触发 memory_limit 或 max_execution_time。不能把所有数据 load 进内存再 insert。
立即学习“PHP免费学习笔记（深入）”；
- 每处理完一个文件，立即用
$pdo->beginTransaction()+ 批量INSERT INTO ... VALUES (...),(...)写入数据库，然后$pdo->commit() - 单次 INSERT 不超过 500 行，防止 SQL 过长或锁表太久
- 调用
gc_collect_cycles()和unset($spreadsheet)显式释放 PhpSpreadsheet 对象引用 - 用
set_time_limit(0)仅在 CLI 环境安全；Web 环境建议拆成 Ajax 分片上传 + session 记录进度
