答案：Laravel通过前端分片、后端接收存储、合并文件及安全优化实现大文件上传。前端用File.slice()切片并上传，后端存入临时目录并记录状态，最后按序合并并清理；需注意唯一标识、过期清理与文件校验。
处理大文件分块上传在 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}/ 目录
路由定义：
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;">$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;">$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}"]);}
4. 安全与优化建议
为确保系统稳定和安全，需注意以下几点：
- 使用唯一 file_id 防止冲突，推荐基于内容生成 SHA256 哈希
- 设置分片过期时间，定时清理未完成的临时文件
- 限制上传频率和并发，防止恶意刷请求
- 校验最终文件类型与大小，避免伪造
- 可结合队列异步处理合并任务，避免阻塞响应
基本上就这些。Laravel 结合前端分片技术，能高效实现大文件上传，关键是做好分块管理与异常处理。整个流程不复杂但容易忽略细节，比如索引错位或临时文件清理。
