🎤 Laravel 文件上传的断点续传与大文件处理高级实现讲座

大家好！欢迎来到今天的讲座，主题是 Laravel 文件上传的断点续传与大文件处理高级实现。如果你曾经在开发中遇到过“超大文件上传失败”或者“网络中断导致上传失败”的问题，那么今天的内容一定会让你豁然开朗！🚀

为了让大家更好地理解这个话题，我会用轻松诙谐的语言讲解，并且附上代码和表格来帮助大家快速上手。准备好了吗？让我们开始吧！

---

🌟 第一部分：为什么需要断点续传？

在现实生活中，我们经常遇到以下场景：

• 用户上传一个 10GB 的视频文件，但网络突然断了。
• 服务器对单个请求的超时时间有限制（比如 PHP 默认的 max_execution_time）。
• 大文件上传可能会占用大量内存，导致服务器崩溃。

为了解决这些问题，我们需要引入 断点续传 技术。它的核心思想是将大文件分成多个小块（chunks），每次只上传一小部分，如果某个部分失败了，可以重新上传这一部分而不需要从头再来。

💡 小贴士：断点续传不仅可以提升用户体验，还能减少带宽浪费和服务器压力。

---

📦 第二部分：实现断点续传的核心逻辑

1. 前端分片上传

前端需要将文件分割成多个小块（chunks），并通过 AJAX 或其他方式逐块上传。以下是使用 JavaScript 实现的示例代码：

// 前端代码：分片上传
async function uploadFile(file, chunkSize = 1024 * 1024 * 5) { // 每块 5MB
    const totalChunks = Math.ceil(file.size / chunkSize);
    for (let i = 0; i < totalChunks; i++) {
        const start = i * chunkSize;
        const end = Math.min(start + chunkSize, file.size);
        const chunk = file.slice(start, end);

        const formData = new FormData();
        formData.append('chunk', chunk);
        formData.append('index', i);
        formData.append('totalChunks', totalChunks);
        formData.append('filename', file.name);

        try {
            await fetch('/upload', {
                method: 'POST',
                body: formData,
            });
            console.log(`Chunk ${i + 1} uploaded successfully.`);
        } catch (error) {
            console.error(`Failed to upload chunk ${i + 1}:`, error);
        }
    }
}

2. 后端合并文件

后端需要接收这些小块文件，并在所有块上传完成后将它们合并成完整的文件。以下是 Laravel 的实现代码：

// 后端代码：接收并合并文件
public function uploadChunk(Request $request)
{
    $chunkIndex = $request->input('index');
    $totalChunks = $request->input('totalChunks');
    $filename = $request->input('filename');

    // 创建临时目录存储每个块
    $tempDir = storage_path('app/temp/' . $filename);
    if (!file_exists($tempDir)) {
        mkdir($tempDir, 0777, true);
    }

    // 保存当前块到临时目录
    $filePath = $tempDir . '/' . $chunkIndex;
    file_put_contents($filePath, $request->file('chunk')->openFile()->fread($request->file('chunk')->getSize()));

    // 如果所有块都上传完毕，则合并文件
    if ($chunkIndex === $totalChunks - 1) {
        $this->mergeChunks($tempDir, $filename);
    }

    return response()->json(['message' => 'Chunk uploaded successfully']);
}

private function mergeChunks($tempDir, $filename)
{
    $finalPath = storage_path('app/uploads/' . $filename);
    $file = fopen($finalPath, 'wb');

    for ($i = 0; $i < count(scandir($tempDir)) - 2; $i++) {
        $chunkPath = $tempDir . '/' . $i;
        if (file_exists($chunkPath)) {
            fwrite($file, file_get_contents($chunkPath));
            unlink($chunkPath); // 删除已合并的块
        }
    }

    fclose($file);
    rmdir($tempDir); // 删除临时目录
}

---

📊 第三部分：性能优化与注意事项

问题	解决方案
网络中断	使用 resume 功能，记录已上传的块，避免重复上传。
内存占用过高	使用流式写入（fwrite）代替一次性加载整个文件。
文件名冲突	在保存文件时添加唯一标识符（如 UUID）。

1. 记录已上传的块

为了避免重复上传，可以在数据库或文件系统中记录每个块的状态。例如，创建一个 uploads 表：

CREATE TABLE uploads (
    id INT AUTO_INCREMENT PRIMARY KEY,
    filename VARCHAR(255),
    chunk_index INT,
    status ENUM('uploaded', 'failed') DEFAULT 'uploaded'
);

在上传前检查哪些块已经成功上传：

$uploadedChunks = DB::table('uploads')
    ->where('filename', $filename)
    ->pluck('chunk_index')
    ->toArray();

if (in_array($chunkIndex, $uploadedChunks)) {
    return response()->json(['message' => 'Chunk already uploaded']);
}

2. 超时设置

在 php.ini 中调整以下参数以支持大文件上传：

• upload_max_filesize：最大文件大小。
• post_max_size：POST 数据的最大大小。
• max_execution_time：脚本执行的最大时间。

---

🎉 第四部分：总结与扩展

通过今天的讲座，我们学习了如何在 Laravel 中实现断点续传和大文件上传。以下是关键点回顾：

• 前端分片上传：将文件分成小块，逐块上传。
• 后端合并文件：接收每个块并最终合并成完整文件。
• 性能优化：记录已上传的块，避免重复上传；使用流式写入减少内存占用。

如果你还想进一步扩展功能，可以尝试以下方向：

• 进度条显示：通过 WebSocket 实时更新上传进度。
• 压缩与解压：上传前压缩文件，下载时解压。
• 多线程上传：同时上传多个块以提高效率。

希望今天的讲座对你有所帮助！如果有任何问题，欢迎随时提问 😄