PHP怎样实现断点续传？大文件分片上传教程-php教程-PHP中文网

PHP怎样实现断点续传？大文件分片上传教程

看不見的法師

发布： 2025-07-04 20:21:02

原创

250人浏览过

php实现大文件断点续传和分片上传的核心方法是将文件切分为多个小块分别上传并在服务端合并。1. 前端使用file api的slice()方法对文件进行分片，每个分片携带序号、唯一标识（如hash）及总分片数信息上传；2. 后端通过php接收分片文件，根据唯一标识保存为临时文件，并记录上传状态；3. 通过循环检查所有分片是否已全部上传完成；4. 所有分片上传完成后按顺序读取并合并生成完整文件，可选择删除原分片文件；注意事项包括合理设置分片大小以平衡请求负担与恢复效率、使用文件哈希避免冲突、前端检查已有上传记录以实现续传功能。整个流程需前后端紧密配合以确保稳定实现大文件上传。

PHP怎样实现断点续传？大文件分片上传教程

大文件上传时经常遇到网络中断、上传超时等问题，PHP实现断点续传和分片上传能有效解决这些问题。核心思路是将大文件切分成多个小块，分别上传，并在服务端进行合并。

1. 前端如何处理文件分片？

要实现断点续传，首先需要前端对文件进行分片处理。常见的做法是使用 File API 的 slice() 方法将文件切割成固定大小的片段（比如2MB）。

const file = document.querySelector('input[type="file"]').files[0];
const chunkSize = 2 * 1024 * 1024; // 每个分片2MB
let chunks = [];
let index = 0;

for (let cur = 0; cur < file.size; cur += chunkSize) {
    const chunk = file.slice(cur, cur + chunkSize);
    chunks.push({
        blob: chunk,
        index: index++
    });
}

登录后复制

每个分片可以带上序号、文件唯一标识（如hash）、总分片数等信息，统一上传到后端。这样即使某个分片失败，也只需要重新上传该部分。

立即学习“PHP免费学习笔记（深入）”；

2. 后端接收并保存分片

PHP这边需要接收这些分片，并保存为临时文件。建议根据上传的唯一标识（例如md5(file.name + size)）来区分不同文件的分片。

接收示例代码：

$uploadDir = 'uploads/';
$fileHash = $_POST['fileHash'];
$chunkIndex = $_POST['chunkIndex'];
$totalChunks = $_POST['totalChunks'];
$chunk = $_FILES['chunk'];

$targetPath = $uploadDir . $fileHash . '_' . $chunkIndex;

if (is_uploaded_file($chunk['tmp_name'])) {
    move_uploaded_file($chunk['tmp_name'], $targetPath);
}

登录后复制

文件名用 hash_分片索引来命名，便于后续合并。
需要记录上传状态，比如是否所有分片都已上传完成。

3. 如何判断是否全部上传完成？

上传完最后一个分片后，服务端需要检查是否存在所有分片文件。可以通过循环判断：

function allChunksUploaded($fileHash, $totalChunks) {
    for ($i = 0; $i < $totalChunks; $i++) {
        if (!file_exists("uploads/{$fileHash}_{$i}")) {
            return false;
        }
    }
    return true;
}

登录后复制

如果所有分片都存在，则开始合并操作。

4. 合并分片生成完整文件

当确认所有分片都上传成功后，就可以按顺序读取各个分片文件，并写入最终的目标文件中：

$finalFilePath = "uploads/final_{$fileHash}.tmp";
$finalFileHandle = fopen($finalFilePath, 'wb');

for ($i = 0; $i < $totalChunks; $i++) {
    $chunkPath = "uploads/{$fileHash}_{$i}";
    $chunkHandle = fopen($chunkPath, 'rb');
    while (!feof($chunkHandle)) {
        fwrite($finalFileHandle, fread($chunkHandle, 8192));
    }
    fclose($chunkHandle);
}

fclose($finalFileHandle);

// 可选：删除所有分片文件
for ($i = 0; $i < $totalChunks; $i++) {
    unlink("uploads/{$fileHash}_{$i}");
}

登录后复制

合并完成后，可以返回一个下载链接或提示用户上传成功。