讲师中心 微信公众号
AI工具推荐 视频效率加速

TP6.0 构建支持断点续传的超大附件上传服务【分片】

浅强大大_8933

浅强大大_8933

发布时间:2026-07-14 17:16:59

|

906人浏览过

|

来源于php中文网

原创

ThinkPHP 6.0超大附件上传服务支持断点续传、分片上传、多并发及刷新不丢进度:前端按2MB切片并生成唯一chunkId,上传前校验存在性,成功后持久化至localStorage;后端用runtime/chunks分目录存储,upload_status表跟踪状态,合并时加锁校验MD5确保原子性。

tp6.0 构建支持断点续传的超大附件上传服务【分片】

你需要在ThinkPHP 6.0项目中搭建一套能真正应对生产环境的超大附件上传服务,要求支持断点续传、分片上传、多文件并发、刷新页面后进度不丢——不是Demo级代码,而是能扛住10GB视频、5万个小文件、IE11+Chrome/Firefox混合访问的真实系统。

前端分片与上传状态持久化

第一步:用File API读取文件并按2MB切片,注意chunkSize必须与后端配置严格一致,否则合并时校验失败。

第二步:对每个分片生成唯一chunkId(推荐用file.name + file.lastModified + sliceIndex拼接MD5),这个ID将贯穿整个上传生命周期,【不可重复、不可随机生成】。

第三步:每次上传前先发GET请求到/api/upload/check?chunkId=xxx&chunkIndex=0,询问该分片是否已存在。服务端返回200表示已存,跳过上传;返回404才执行POST上传。这一步省掉重复传输,也避免断点恢复时误重传。

第四步:上传成功后立即调用localStorage.setItem('upload_' + chunkId, JSON.stringify({index: i, status: 'success', time: Date.now()}))。别用sessionStorage——它在刷新后清空,断点续传就失效了。

TP6控制器接收与临时存储

方法一:使用request()->file()直接接收单个分片

在app/controller/Upload.php中定义uploadChunk方法,接收chunkid、chunkindex、chunkcount、filename参数;【务必校验chunkindex是否为数字且≥0,防止路径穿越攻击】。

方法二:手动读取原始流避免TP6自动解析干扰

当遇到超大分片或Nginx限制时,改用file_get_contents('php://input')获取原始二进制流,再用file_put_contents写入临时目录。这种方式绕过TP6文件校验,但需自行做MIME类型白名单过滤。

所有分片统一存到runtime/upload/chunks/{date}/{chunkid}/目录下,文件名格式为{chunkid}-{chunkindex}.tmp。日期子目录可防止单目录文件过多导致Linux ext4性能下降。

ThinkPHP5.1企业站点快速开发-源码课件
ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载

服务端断点状态管理

第一步:创建upload_status表,字段含id、chunkid、total_chunks、uploaded_count、status('uploading'/'completed'/'failed')、updated_time。

第二步:每次分片上传成功,执行INSERT ... ON DUPLICATE KEY UPDATE语句更新uploaded_count,同时记录updated_time。主键设为chunkid,避免重复插入。

第三步:用户刷新页面后,前端调用/api/upload/status?chunkid=xxx,后端查upload_status表返回当前已上传分片索引数组,前端据此跳过已传分片,从第一个missing index继续。

第四步:若某分片连续3次上传失败(HTTP 500或超时),status置为'failed',并记录错误码。前端收到后弹窗提示“第X块上传失败,请检查网络”,不自动重试——避免死循环刷爆磁盘。

合并逻辑与原子性保障

当最后一个分片(chunkindex == chunkcount - 1)上传完成,触发合并流程:

① 先用flock加写锁,防止多个请求同时合并同一文件;

② 遍历检查所有分片文件是否存在且大小正确(每个应≈2MB,最后一片可能略小);

③ 按chunkindex升序逐个fopen→fread→fwrite追加到目标文件;

④ 合并完成后计算最终文件MD5,与前端传来的fileMd5比对,不一致则unlink目标文件并报错;

⑤ 成功后清理所有.tmp分片文件,并将upload_status.status更新为'completed'。

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

相关专题

更多
Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

0

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

0

2026.10.22

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

0

2026.10.22

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

0

2026.10.22

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。

0

2026.10.22

Golangci-lint安装与入门教程
Golangci-lint安装与入门教程

本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。

0

2026.10.22

PHP2Shell高危漏洞修复教程
PHP2Shell高危漏洞修复教程

PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。

60

2026.10.22

剧云人物设定与关系管理教程
剧云人物设定与关系管理教程

本专题介绍剧云人物设定与关系管理,讲解角色小传、性格职业、人物目标、背景资料和关系网络的创建及维护方法。

0

2026.10.22

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn