一、总体设计与目标
1. 需求背景
大文件上传在web应用中极易遇到网络波动、客户端中断或浏览器崩溃等情况，因此需要通过分片上传和断点续传来提高鲁棒性和用户体验。实现方案的核心在于将超大文件拆分成较小的数据块，逐块传输并在服务端进行重组。分片上传和断点续传共同构成完整的上传体系。
本文聚焦“如何用PHP实现大文件上传的分片与断点续传”这一主题，提供从前端分片、到后端接收、再到断点续传的完整实战方案。重点在于实现过程的可重复性、可维护性以及在生产环境中的稳定性。完整实战指南围绕技术要点展开，避免空洞的理论描述。
2. 技术要点
实现一个可用的分片上传系统，需掌握以下要点：上传ID用于标识同一个文件的所有分片、分片索引用于有序重组、总分片数用于判断是否已上传完成、以及最终合并逻辑。通过这些要点，可以实现断点续传以及高并发场景下的正确合并。
另外，服务端需要考虑幂等性、并发写入保护、以及对上传数据的安全性控制（如大小限制、类型校验、权限控制等）。这些设计在后续章节中有详细的落地实现。
二、前端实现：分片上传的客户端逻辑
1. 方案概览
前端通过File API读取本地文件，使用 slice() 将文件切分为固定大小的分片，然后通过 FormData 将分片逐块发送到服务端。常见的分片大小为 1MB~4MB，权衡点在于网络波动时的重试成本与服务器并发处理能力之间的平衡。
为了实现断点续传，需要在客户端记录已经上传的分片信息并在再次上传时从上次中断的位置继续，避免重复传输与加重服务器压力。下文的示例将给出完整的实现要点与代码片段。
2. 关键步骤
核心步骤包括：文件读取、分片计算、分片逐个上传、上传进度的持久化存储、失败重试和断点续传的恢复。Progress tracking与retry/backoff策略是保证用户体验的关键。
示例中会给出一个最小可运行的前端实现，结合后端的分片接收逻辑即可完整工作。
// 前端：简单的分片上传（JavaScript）
// 说明：将一个 File 对象分成固定大小的分片，逐个上传到 upload_chunk.php
(function(){const CHUNK_SIZE = 1024 * 1024; // 1MBfunction uid() { return 'u' + Date.now() + '-' + Math.random().toString(36).slice(2); }window.uploadFileInChunks = async function(file) {const uploadId = uid();const totalChunks = Math.ceil(file.size / CHUNK_SIZE);let chunkIndex = 0;const filename = file.name;const progressKey = 'upload_progress_' + uploadId;localStorage.setItem(progressKey, JSON.stringify({ uploaded: 0, total: totalChunks }));while (chunkIndex < totalChunks) {const start = chunkIndex * CHUNK_SIZE;const end = Math.min(start + CHUNK_SIZE, file.size);const blob = file.slice(start, end);const form = new FormData();form.append('upload_id', uploadId);form.append('filename', filename);form.append('chunk_index', chunkIndex.toString());form.append('total_chunks', totalChunks.toString());form.append('chunk_size', (end - start).toString());form.append('file', blob, filename);try {const resp = await fetch('upload_chunk.php', { method: 'POST', body: form });const data = await resp.json();if (data.status === 'done') {// 全部分片已合并localStorage.removeItem(progressKey);console.log('上传完成，文件保存至：', data.path);break;} else if (data.status === 'ok' || data.index === chunkIndex) {// 当前分片上传成功，继续下一个chunkIndex++;const progress = { uploaded: chunkIndex, total: totalChunks };localStorage.setItem(progressKey, JSON.stringify(progress));} else {// 服务端返回其他状态，进行轻度重试throw new Error('Unexpected server response');}} catch (e) {// 简单重试策略：1 秒后重试console.warn('分片上传失败，重试中...', e);await new Promise(r => setTimeout(r, 1000));}}};
})();
三、服务端实现：PHP 接收分片与合并
1. 处理流程
后端接收来自前端的分片请求后，将分片保存到临时目录中，按 upload_id 与 chunk_index 进行命名，确保能够按顺序重组。只有当所有分片都到齐时，才执行最终的合并操作，避免在未接收完毕时就写出最终文件。 分片命名策略可以是 {upload_id}.part{chunk_index}，便于后续排序与清理。
完成合并后，应返回明确的状态信息，如 path 指向最终文件路径，方便客户端做后续处理。
2. 关键实现要点
在高并发场景下，建议对写入临时分片的操作进行 文件锁（ flock）保护，避免同一分片写入冲突导致数据损坏。此外，务必对上传的文件名、大小进行校验，并设置服务器端的上传容量与时间限制。
'error', 'message' => 'No file data']);exit;
}// 保存当前分片到临时目录
$tmpChunkPath = $tmpDir . '/' . $uploadId . '.part' . $chunkIndex;
if (!move_uploaded_file($_FILES['file']['tmp_name'], $tmpChunkPath)) {echo json_encode(['status' => 'error', 'message' => 'Failed to save chunk']);exit;
}// 检查是否已收齐所有分片
$allExist = true;
for ($i = 0; $i < $totalChunks; $i++) {if (!file_exists($tmpDir . '/' . $uploadId . '.part' . $i)) {$allExist = false;break;}
}if ($allExist) {$outPath = $finalDir . '/' . $filename;$fp = fopen($outPath, 'wb');if (!$fp) {echo json_encode(['status' => 'error', 'message' => 'Cannot write final file']);exit;}for ($i = 0; $i < $totalChunks; $i++) {$chunkPath = $tmpDir . '/' . $uploadId . '.part' . $i;$chunkFp = fopen($chunkPath, 'rb');if (!$chunkFp) { fclose($fp); echo json_encode(['status' => 'error', 'message' => 'Chunk read error']); exit; }while (!feof($chunkFp)) {$buf = fread($chunkFp, 1024 * 1024);fwrite($fp, $buf);}fclose($chunkFp);@unlink($chunkPath);}fclose($fp);@rmdir($tmpDir);echo json_encode(['status' => 'done', 'path' => $outPath]);
} else {echo json_encode(['status' => 'ok']);
}
?>
四、断点续传实现：状态管理与重试策略
1. 前端状态保存
通过 localStorage 保存正在上传的文件的进度信息，关键字段包括 upload_id、已上传分片数、总分片数等，以便在网络中断后能够从上次断点继续上传。
客户端在每次上传分片成功后更新进度，若发生网络异常，则根据上次进度重新发起上传，确保数据不重复提交且最终完成。
2. 重试策略与幂等性
实现一个简单的重试策略：设置最大重试次数、指数级退避等，并在服务端返回“ok”或“done”时终止重试。确保同一个分片的多次上传行为不会对最终文件造成影响，这也是断点续传的关键点。
// 前端：简单的断点续传重试策略示例
// 伪代码，展示重试与进度更新的核心思想
const MAX_RETRIES = 3;async function uploadChunkWithRetry(form, attempt = 1) {try {const res = await fetch('upload_chunk.php', { method: 'POST', body: form });const data = await res.json();if (data.status === 'done') return true;if (data.status === 'ok' || data.index !== undefined) return false;throw new Error('Unexpected response');} catch (e) {if (attempt <= MAX_RETRIES) {await new Promise(r => setTimeout(r, 1000 * Math.pow(2, attempt)));return await uploadChunkWithRetry(form, attempt + 1);} else {throw e;}}
}
五、性能、部署与安全要点
1. 服务端性能与并发控制
在高并发上传场景下，应对并发写入进行控制，例如限制同一时刻的活动分片数量、使用队列机制以及对临时分片采用流式写入而非一次性加载到内存。流式写入和异步处理有助于降低内存压力，提高吞吐量。
同时要注意服务器的 I/O 带宽、磁盘写入速度以及临时文件的清理策略，以避免磁盘占用过高导致系统不稳定。
2. 安全与合规
对上传文件进行严格的校验：白名单类型、大小限制、MIME 类型校验、文件名清洗、以及对上传接口的 CSRF 保护与鉴权。必要时结合后端病毒扫描、完整性校验（如哈希）等手段确保安全。
通过上述设计与实现，可以在 PHP 环境下完成一个完整的大文件上传分片与断点续传方案。本文所给代码片段与思路均可直接落地到实际项目中，帮助开发者快速搭建高鲁棒性的上传能力。
