PHP导入班级通信录支持断点续传需流式读取CSV、持久化记录最后处理的行号或主键（如student_id）、入库前校验幂等性、事务提交后更新断点，并统一编码、避免并发冲突。
PHP 导入班级通信录时如何支持断点续传
断点续传不是 PHP 自带功能，必须靠开发者自己记录导入进度。核心思路是：每次成功写入一批数据后，把最后处理的行号或唯一标识（如学号）存到数据库或文件中；下次导入时先读这个位置，跳过已处理的数据。
- 不要依赖
$_FILES上传后直接全量解析 CSV —— 大文件会超内存、超时，且无法中断恢复 - 推荐用
fgetcsv()流式读取，配合ftell()记录文件指针位置，或用行号（$lineNumber）做断点标记 - 断点信息必须持久化：写进数据库比写文件更可靠（避免并发冲突、权限问题），字段建议包含
task_id、last_line、status、updated_at - 注意 CSV 中含换行符（如地址字段含 \n）会导致
fgetcsv()行号错乱，务必用str_getcsv()+ 手动按 \r\n 切分并校验引号配对，或改用League\Csv库处理复杂格式
怎么设计“续传未导入数据”的执行逻辑
关键不是重跑整个文件，而是从上次中断处继续。这要求导入流程可拆解为原子操作，并能明确判断某条记录是否已入库。
- 每条学生记录入库前先查
SELECT 1 FROM students WHERE student_id = ?，存在则跳过 —— 这是“幂等性”基础，防止重复插入 - 断点位置不能只记行号，还要结合业务主键（如
student_id或class_id + name联合唯一）校验，避免因文件内容变动（删行/插行）导致跳过错误数据 - 使用事务要谨慎：
INSERT ... ON DUPLICATE KEY UPDATE比手动查+插更高效，但需确保表有合适唯一索引（如UNIQUE(student_id)） -
前端触发续传时，应传
task_id而非文件名，后端据此查出last_line和文件存储路径（如/upload/task_abc123.csv），再fopen()定位到对应行
常见失败场景与避坑点
断点续传真正难的不是代码，而是状态一致性。很多“续传失败”其实是中间态没清理干净造成的。
- PHP 脚本超时（
max_execution_time）或内存溢出时，last_line可能已更新但数据没写完 → 必须在事务提交成功后才更新断点值 - 用户重复点击“开始导入”，产生多个并发任务写同一张表 → 用
INSERT IGNORE或加FOR UPDATE锁住断点记录行，避免覆盖 - CSV 编码为 GBK 但 PHP 默认 UTF-8 解析，中文字段乱码导致
student_id匹配失败，看起来像“重复导入” → 统一转为 UTF-8 再处理，可用mb_convert_encoding($line, 'UTF-8', 'GBK') - 用
file_get_contents()一次性读全文件再explode("\n")，看似简单，但大文件直接崩 —— 必须流式处理，哪怕多花 20 行代码
一个最小可行的断点续传导入片段
以下仅示意核心控制流，不封装、不异常处理，方便你快速对齐逻辑：
立即学习“PHP免费学习笔记（深入）”；
// 假设已知 task_id = 123，查出 last_line = 45
$fp = fopen('/upload/task_123.csv', 'r');
for ($i = 0; $i < 45; $i++) {
fgetcsv($fp); // 跳过已处理行
}
while (($row = fgetcsv($fp)) !== false) {
$studentId = $row[0];
// 先查是否存在
$exists = $pdo->prepare("SELECT 1 FROM students WHERE student_id = ?")->execute([$studentId])->fetch();
if ($exists) continue;
// 插入
$pdo->prepare("INSERT INTO students (student_id, name, phone) VALUES (?, ?, ?)")->execute([$studentId, $row[1], $row[2]]);
// 更新断点（放在循环末尾，保证至少处理完当前行）
$pdo->prepare("UPDATE import_tasks SET last_line = ? WHERE id = ?")->execute([$i + 46, 123]);
$i++;
}
fclose($fp);
实际项目里，行号容易漂移，更稳妥的是用最后一行的 student_id 作为断点标记，再配合 WHERE student_id > ? ORDER BY student_id LIMIT 100 分页导入 —— 这种方式对文件顺序无依赖，但要求数据本身有序或可排序。
