本文围绕标题 PHP大文件分片上传与断点续传的实现方法：从原理到实战展开系统讲解，帮助开发者从理论到落地方案全面掌握大文件上传的核心技术要点。
1. 原理与设计
1.1 分片上传的基本原理
在大文件上传场景中，分片上传将原始文件拆分成若干可控大小的块，逐块通过 HTTP 发送，这样可以显著降低单次请求的压力并提升网络容错性。合理的分块大小通常取决于网络带宽、服务器处理能力以及前端浏览器对内存的限制，常见取值为 256KB、1MB、2MB 之间的选项。
实现要点包括：全局上传标识符 uploadId、分片索引 idx、总分片数 totalChunks，以及一个可选的 校验字段。这些字段共同确保分片按正确顺序、逐步完成并且具备断点续传能力。
'ok', 'idx' => $idx]);
} else {echo json_encode(['status' => 'error', 'message' => 'no_file']);
}
?>关键点总结：通过分片传输和唯一的上传标识符，可以实现对大文件的分步上传与断点续传能力，确保在网络波动下也能逐步完成上传过程。
1.2 断点续传的核心概念
断点续传的核心在于记录已经接收的分片状态，并在重新连接时从最近的未上传分片继续。客户端需要维护一个全局的 uploadId 与分片进度信息，服务器端则通过该信息恢复上次上传的状态。
常见做法包括：进度持久化、幂等性处理、以及对重复分片的 幂等覆盖。通过这些机制，可以保证即使多次请求重复提交，最终结果也一致且正确。
'ok', 'idx' => $idx]);
?>通过上述设计，前后端可以在中断后快速恢复，减少重复传输与等待时间，并提升用户体验。
2. PHP后端实现
2.1 接收分片的关键
后端入口通常为 receiveChunk.php，它需要完成以下工作：校验参数、定位或创建临时目录、将分片写入临时文件，并返回简要状态以供前端判断下一步。
为便于后续合并，分片应命名为 chunk_
'ok', 'idx' => $idx]);} else {echo json_encode(['status' => 'error', 'message' => 'move_failed']);}
} else {echo json_encode(['status' => 'error', 'message' => 'no_file']);
}
?>在高并发场景下，需考虑对同一分片的重复上传进行幂等处理，并对上传的 uploadId 做身份校验与权限控制。
2.2 分片合并与完整性校验
当客户端告知“已完成所有分片上传”或上传达到总分片数时，后端应按顺序将 chunk_0、chunk_1、…、chunk_N 合并到目标文件中。顺序合并是保证最终文件正确性的关键。
合并完成后，建议进行简单的完整性校验，如对比 目标文件大小、或进行 哈希校验，以确认文件未在传输过程中损坏。随后清理临时分片，释放磁盘资源以避免长期占用。
'merged', 'size' => filesize($dest)]);
?>3. 前端实现（客户端）
3.1 进行分片上传的脚本
前端通过 File 对象和 Blob 的 slice 方法将文件切分为固定大小的 chunks。每个 chunk 使用独立的请求上传，携带 uploadId、idx、filename 与 chunk 数据。为提升稳定性，可以选择串行或受控并发上传策略，并对失败分片进行重试。
这里给出一个简化的 JavaScript 实现示例，展示如何切片、发送并在合适时机发起合并请求。
// client.js 简化示例
async function uploadFile(file) {const chunkSize = 1024 * 1024; // 1MBconst totalChunks = Math.ceil(file.size / chunkSize);const uploadId = 'upl_' + Date.now() + '_' + Math.random().toString(36).slice(2, 7);for (let idx = 0; idx < totalChunks; idx++) {const start = idx * chunkSize;const end = Math.min(start + chunkSize, file.size);const blob = file.slice(start, end);const form = new FormData();form.append('uploadId', uploadId);form.append('idx', idx);form.append('filename', file.name);form.append('file', blob, file.name);// 采用串行上传确保顺序，或改为并发控制await fetch('/receiveChunk.php', { method: 'POST', body: form });}// 上传完成后触发合并const mergeForm = new FormData();mergeForm.append('uploadId', uploadId);mergeForm.append('filename', file.name);await fetch('/mergeChunks.php', { method: 'POST', body: mergeForm });
}
3.2 断点续传与错误处理
断点续传通常依赖于浏览器本地存储来保存上传任务信息，例如 localStorage 保存的 uploadId、filename、totalChunks、以及已完成的 idx列表。刷新后重新加载这些信息，继续未完成的分片上传。
错误处理策略包括网络错误的重试、服务器返回错误的回退处理，以及对分片丢失的补传逻辑。通过将状态持久化在本地，可以实现稳健的断点续传体验。
// client.js 断点续传简化示例
async function resumeUpload(file, saved) {const chunkSize = 1024 * 1024;const totalChunks = Math.ceil(file.size / chunkSize);const uploadId = saved.uploadId;const uploaded = new Set(saved.uploaded || []);for (let idx = 0; idx < totalChunks; idx++) {if (uploaded.has(idx)) continue;const start = idx * chunkSize;const end = Math.min(start + chunkSize, file.size);const blob = file.slice(start, end);const form = new FormData();form.append('uploadId', uploadId);form.append('idx', idx);form.append('filename', file.name);form.append('file', blob, file.name);try {await fetch('/receiveChunk.php', { method: 'POST', body: form });uploaded.add(idx);localStorage.setItem('upload_' + file.name, JSON.stringify({ uploadId, uploaded: Array.from(uploaded) }));} catch (e) {// 简单重试逻辑idx--;}}// 最后合并const mergeForm = new FormData();mergeForm.append('uploadId', uploadId);mergeForm.append('filename', file.name);await fetch('/mergeChunks.php', { method: 'POST', body: mergeForm });
}
