0

0

Laravel如何实现多文件分片上传?(大文件处理)

裘德小鎮的故事

裘德小鎮的故事

发布时间:2026-03-12 01:01:23

|

359人浏览过

|

来源于php中文网

原创

laravel大文件分片上传通过前端切片、服务端暂存与合并实现,支持断点续传和异步处理。前端按2mb切片并上传,服务端用redis记录状态,最后流式合并或交由队列异步完成,同时基于sha-256校验去重。

laravel如何实现多文件分片上传?(大文件处理)

如果您在Laravel应用中需要上传大文件,但受限于PHP内存限制、超时设置或网络不稳定导致单次上传失败,则可采用分片上传策略。以下是实现多文件分片上传的具体方法:

一、前端分片与合并逻辑

该方法依赖前端将大文件切分为固定大小的块(如2MB/片),逐个上传,并在服务端记录分片状态,最终触发合并操作。需配合唯一文件标识(如文件hash)避免重复上传相同分片。

1、使用JavaScript FileReader API读取文件并按指定大小切片。

2、为每个分片生成唯一标识符,包含文件名、总片数、当前序号和文件MD5。

3、通过POST请求向Laravel接口上传单个分片,携带分片元数据(如chunkIndex、totalChunks、fileIdentifier)。

4、前端在所有分片上传成功后,发起合并请求,传入fileIdentifier及原始文件名。

二、Laravel服务端分片接收与存储

此方法在控制器中接收分片,校验完整性后暂存至临时目录,使用Redis或数据库记录已上传分片索引,防止重复提交或丢失。

1、定义路由 POST /api/upload/chunk 接收单个分片,验证请求中是否包含fileIdentifier、chunkIndex、totalChunks参数。

2、检查storage/app/chunks/{fileIdentifier}/目录是否存在,若不存在则创建。

3、将接收到的文件内容写入storage/app/chunks/{fileIdentifier}/{chunkIndex},使用file_put_contents确保原子写入。

4、使用Redis SETNX命令记录该分片已接收,键名为upload:chunks:{fileIdentifier}:{chunkIndex},值为1,过期时间设为24小时。

三、服务端分片合并与文件落盘

当所有分片确认上传完成,系统将按序号拼接各分片内容,生成完整文件,并删除临时分片目录。合并前需校验分片总数与实际接收数量一致。

1、定义路由 POST /api/upload/merge 接收fileIdentifier和originalName参数。

I-Shop购物系统
I-Shop购物系统

部分功能简介:商品收藏夹功能热门商品最新商品分级价格功能自选风格打印结算页面内部短信箱商品评论增加上一商品,下一商品功能增强商家提示功能友情链接用户在线统计用户来访统计用户来访信息用户积分功能广告设置用户组分类邮件系统后台实现更新用户数据系统图片设置模板管理CSS风格管理申诉内容过滤功能用户注册过滤特征字符IP库管理及来访限制及管理压缩,恢复,备份数据库功能上传文件管理商品类别管理商品添加/修改/

下载

2、从Redis中查询upload:chunks:{fileIdentifier}:*匹配的所有key,统计实际接收分片数。

3、若统计数量等于totalChunks,则按chunkIndex升序读取各分片内容,使用fopen('php://output', 'wb')流式写入目标路径storage/app/uploads/{originalName}。

4、合并完成后,执行Redis DEL upload:chunks:{fileIdentifier}:* 并递归删除storage/app/chunks/{fileIdentifier}/目录。

四、基于Laravel Job的异步合并处理

为避免HTTP请求超时,可将合并操作交由队列异步执行。上传完最后一个分片后仅触发Job投递,由Worker进程完成读取、拼接与清理。

1、在分片上传完成判断逻辑中,调用dispatch(new MergeChunkJob($fileIdentifier, $originalName))。

2、MergeChunkJob构造函数中保存$fileIdentifier和$originalName,并在handle()方法中执行分片读取与合并。

3、使用Storage::disk('local')->readStream()逐个打开分片流,通过stream_copy_to_stream()追加写入目标文件句柄。

4、合并成功后,调用Storage::disk('local')->deleteDirectory("chunks/{$fileIdentifier}")清除临时数据。

五、断点续传与分片去重支持

该方法通过文件内容哈希(如SHA-256)识别已存在分片,允许客户端跳过已上传成功的块,提升大文件重试效率。

1、前端在上传前计算每个分片的SHA-256值,并随请求发送sha256参数。

2、服务端接收分片前,先查询Redis中是否存在键upload:sha256:{sha256},若存在则直接返回“已存在”,不重复写入。

3、若不存在,则正常写入分片,并同时设置upload:sha256:{sha256} = {fileIdentifier}:{chunkIndex},TTL同上。

4、在合并阶段,依据fileIdentifier查出全部chunkIndex列表,再反查对应sha256是否全部命中,缺失任一分片则拒绝合并并返回错误码400

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

339

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

293

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

772

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

385

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

141

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

85

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

80

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

453

2026.03.04

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

3

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

PHP自制框架
PHP自制框架

共8课时 | 0.6万人学习

PHP面向对象基础课程(更新中)
PHP面向对象基础课程(更新中)

共12课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号