PHP实现大文件分片上传与断点续传方法

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

大文件上传时经常遇到网络中断、上传超时等问题，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）、总分片数等信息，统一上传到后端。这样即使某个分片失败，也只需要重新上传该部分。

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}");
}

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

补充几点注意事项：

• 使用文件哈希作为唯一标识，避免同名文件冲突。
• 分片大小不宜过小（如小于1MB），否则会增加HTTP请求负担；也不宜过大，影响断点恢复效率。
• 建议前端每次上传前先检查是否已有上传记录（通过hash查询接口），实现真正的“续传”功能。
• 如果要做更完善的系统，可引入数据库记录上传状态，甚至支持暂停、重试等功能。

基本上就这些。整个流程不复杂但细节很多，尤其是前后端配合的部分容易出问题。只要把分片逻辑、标识机制和合并流程理清楚，就能稳定实现大文件上传。