断点续传通过文件分片、唯一hash标识、服务端记录上传状态实现，前端切片上传并查询已传分片，PHP后端存储分片并在完成后合并，同时提供状态接口支持续传，需注意hash一致性与临时文件清理。
大文件上传在Web开发中是个常见需求，尤其是涉及视频、备份文件或资源包时。PHP本身对文件上传有一定限制，但通过合理设计可以实现断点续传和大文件分片上传，提升用户体验和系统稳定性。
1. 断点续传的基本原理
断点续传的核心是将大文件切分成多个小块（chunk），逐个上传。服务端记录已上传的分片，客户端可查询上传进度，并从中断处继续上传，避免重复传输。
关键点包括：
- 文件分片：前端使用File API将文件切片，每片单独请求上传
- 唯一标识：为每个文件生成唯一hash（如md5），用于识别同一文件的上传状态
- 服务端记录：用文件名+分片序号标记已上传的块，支持校验与合并
- 恢复机制：上传前查询已传分片，跳过已完成的部分
2. 前端实现分片上传
使用JavaScript的File对象进行切片：
立即学习“PHP免费学习笔记（深入）”；
const file = document.getElementById('file').files[0];
const chunkSize = 1024 * 1024; // 1MB每片
const chunks = [];
let start = 0;
while (start < file.size) {
const chunk = file.slice(start, start + chunkSize);
chunks.push(chunk);
start += chunkSize;
}
// 上传每一片
chunks.forEach((chunk, index) => {
const formData = new FormData();
formData.append('file', chunk);
formData.append('filename', file.name);
formData.append('chunkIndex', index);
formData.append('totalChunks', chunks.length);
formData.append('fileHash', fileHash); // 可通过spark-md5等库计算
fetch('/upload.php', {
method: 'POST',
body: formData
});
});
3. PHP后端处理分片与合并
接收分片并存储到临时目录，上传完成后触发合并：
- 检查上传目录权限，确保可写
- 根据fileHash和chunkIndex保存分片文件
- 所有分片上传完毕后，按顺序合并成完整文件
$uploadDir = 'uploads/'; $tempDir = $uploadDir . 'temp/'; $fileHash = $_POST['fileHash']; $chunkIndex = $_POST['chunkIndex']; $totalChunks = $_POST['totalChunks']; $fileName = $_POST['filename'];// 创建临时目录 if (!is_dir($tempDir)) mkdir($tempDir, 0777, true);
$targetPath = $tempDir . $fileHash . '_' . $chunkIndex;
if (isset($_FILES['file']) && $_FILES['file']['error'] == 0) { move_uploaded_file($_FILES['file']['tmp_name'], $targetPath); }
// 检查是否全部上传完成 $uploadedChunks = glob($tempDir . $fileHash . '_*'); if (count($uploadedChunks) == $totalChunks) { // 合并文件 $finalFile = $uploadDir . $fileName; file_put_contents($finalFile, ''); // 清空目标文件
for ($i = 0; $i < $totalChunks; $i++) { $chunkFile = $tempDir . $fileHash . '_' . $i; if (file_exists($chunkFile)) { file_put_contents($finalFile, file_get_contents($chunkFile), FILE_APPEND); unlink($chunkFile); // 删除分片 } } }
4. 支持断点续传的状态查询
提供一个接口供前端查询已上传的分片：
// check_upload_status.php $fileHash = $_GET['fileHash']; $totalChunks = $_GET['totalChunks']; $uploaded = [];for ($i = 0; $i < $totalChunks; $i++) { if (fileexists("uploads/temp/{$fileHash}{$i}")) { $uploaded[] = $i; } } echo json_encode(['uploaded' => $uploaded]);
前端调用该接口后，只上传缺失的分片即可实现“续传”。
基本上就这些。通过分片上传 + 文件标识 + 状态记录，就能在PHP中实现稳定的大文件断点续传功能。关键是前后端配合好分片逻辑和状态同步。不复杂但容易忽略细节，比如hash一致性、临时文件清理、上传超时等问题需要额外处理。
