断点续传通过文件分片、唯一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;
<p>while (start < file.size) {
const chunk = file.slice(start, start + chunkSize);
chunks.push(chunk);
start += chunkSize;
}</p><p>// 上传每一片
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等库计算</p><p>fetch('/upload.php', {
method: 'POST',
body: formData
});
});</p>3. PHP后端处理分片与合并
接收分片并存储到临时目录，上传完成后触发合并：
- 检查上传目录权限，确保可写
- 根据fileHash和chunkIndex保存分片文件
- 所有分片上传完毕后，按顺序合并成完整文件
$uploadDir = 'uploads/';
$tempDir = $uploadDir . 'temp/';
$fileHash = $_POST['fileHash'];
$chunkIndex = $_POST['chunkIndex'];
$totalChunks = $_POST['totalChunks'];
$fileName = $_POST['filename'];
<p>// 创建临时目录
if (!is_dir($tempDir)) mkdir($tempDir, 0777, true);</p><p>$targetPath = $tempDir . $fileHash . '_' . $chunkIndex;</p><p>if (isset($_FILES['file']) && $_FILES['file']['error'] == 0) {
move_uploaded_file($_FILES['file']['tmp_name'], $targetPath);
}</p><p>// 检查是否全部上传完成
$uploadedChunks = glob($tempDir . $fileHash . '_*');
if (count($uploadedChunks) == $totalChunks) {
// 合并文件
$finalFile = $uploadDir . $fileName;
file_put_contents($finalFile, ''); // 清空目标文件</p><p>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); // 删除分片
}
}
}</p>4. 支持断点续传的状态查询
提供一个接口供前端查询已上传的分片：
// check_upload_status.php
$fileHash = $_GET['fileHash'];
$totalChunks = $_GET['totalChunks'];
$uploaded = [];
<p>for ($i = 0; $i < $totalChunks; $i++) {
if (file<em>exists("uploads/temp/{$fileHash}</em>{$i}")) {
$uploaded[] = $i;
}
}
echo json_encode(['uploaded' => $uploaded]);</p>前端调用该接口后，只上传缺失的分片即可实现“续传”。
基本上就这些。通过分片上传 + 文件标识 + 状态记录，就能在PHP中实现稳定的大文件断点续传功能。关键是前后端配合好分片逻辑和状态同步。不复杂但容易忽略细节，比如hash一致性、临时文件清理、上传超时等问题需要额外处理。
