laravel如何处理大文件分块上传_Laravel大文件分块上传方法-Laravel-PHP中文网

laravel如何处理大文件分块上传_Laravel大文件分块上传方法

裘德小鎮的故事

发布： 2025-10-04 21:51:02

原创

987人浏览过

答案：Laravel通过前端分片、后端接收存储、合并文件及安全优化实现大文件上传。前端用File.slice()切片并上传，后端存入临时目录并记录状态，最后按序合并并清理；需注意唯一标识、过期清理与文件校验。

laravel如何处理大文件分块上传_laravel大文件分块上传方法

处理大文件分块上传在 Laravel 中是常见需求，尤其涉及视频、备份或大型文档时。直接上传大文件容易超时或占用过多内存，因此采用分块上传（chunked upload）能有效提升稳定性与用户体验。以下是 Laravel 实现大文件分块上传的核心方法。

1. 前端分片与上传逻辑

前端需将文件切分为多个小块，逐个发送到后端。通常使用 JavaScript 的 File.slice() 方法进行切片，并通过 AJAX 上传每个片段。

用户选择文件后，按固定大小（如 5MB）切片
每片携带唯一标识（如文件哈希）、当前块序号、总块数等信息
使用 FormData 发送 POST 请求到 Laravel 接口

示例代码片段：

const file = document.getElementById('file').files[0];
const chunkSize = 5 * 1024 * 1024; // 5MB
const chunks = Math.ceil(file.size / chunkSize);
const fileId = btoa(file.name + file.size + file.lastModified); // 简单哈希
<p>for (let i = 0; i < chunks; i++) {
const start = i * chunkSize;
const end = Math.min(start + chunkSize, file.size);
const chunk = file.slice(start, end);</p><p>const formData = new FormData();
formData.append('file', chunk);
formData.append('file_id', fileId);
formData.append('index', i);
formData.append('total', chunks);</p><p>await fetch('/upload/chunk', {
method: 'POST',
body: formData,
headers: {
'X-CSRF-TOKEN': document.querySelector('meta[name="csrf-token"]').getAttribute('content')
}
});
}

登录后复制

2. 后端接收并存储分片

Laravel 路由接收分片请求，将每个块保存到临时目录，并记录状态。

创建路由 POST /upload/chunk
验证上传数据完整性
将分片存入 storage/app/chunks/{fileId}/ 目录

路由定义：

文心大模型

百度飞桨-文心大模型 ERNIE 3.0 文本理解与创作

查看详情

Route::post('/upload/chunk', [UploadController::class, 'storeChunk']);

登录后复制

控制器方法示例：

public function storeChunk(Request $request)
{
    $request->validate([
        'file' => 'required|file|max:5120', // 单块不超过 5MB
        'file_id' => 'required|string',
        'index' => 'required|integer',
        'total' => 'required|integer'
    ]);
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">$fileId = $request->file_id;
$index = $request->index;
$total = $request->total;

$path = "chunks/{$fileId}";
$fileName = "part_{$index}";

$request->file('file')->storeAs($path, $fileName);

// 可选：记录数据库状态
Cache::put("upload_{$fileId}_status", [
    'uploaded' => $index + 1,
    'total' => $total
], 3600);

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

登录后复制

}

3. 合并分片文件

当所有分片上传完成后，触发合并操作。可通过前端通知或轮询判断是否完成。

检查指定目录下是否已上传全部分片
按顺序读取并拼接文件
合并后删除临时分片

合并方法示例：

public function mergeChunks(Request $request)
{
    $fileId = $request->input('file_id');
    $filename = $request->input('filename');
    $total = $request->input('total');
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">$chunkPath = storage_path("app/chunks/{$fileId}");
$destination = storage_path("app/uploads/{$filename}");

if (!is_dir($chunkPath)) {
    return response()->json(['error' => 'Chunks not found'], 404);
}

$handle = fopen($destination, 'wb');
for ($i = 0; $i < $total; $i++) {
    $partPath = "{$chunkPath}/part_{$i}";
    if (file_exists($partPath)) {
        fwrite($handle, file_get_contents($partPath));
        unlink($partPath); // 删除已合并的分片
    } else {
        fclose($handle);
        unlink($destination);
        return response()->json(['error' => "Missing chunk {$i}"], 400);
    }
}
fclose($handle);

// 清理缓存
Cache::forget("upload_{$fileId}_status");
rmdir($chunkPath);

return response()->json(['message' => 'File merged successfully', 'path' => "/storage/uploads/{$filename}"]);

登录后复制

}