讲师中心 微信公众号

工具推荐

视频效率加速
updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

Laper
Laper

剧本策划到成片协作

HTML如何实现文件夹上传?完整代码步骤

夏伟同学_3185

夏伟同学_3185

发布时间:2026-11-22 06:01:06

|

828人浏览过

|

来源于php中文网

原创

HTML原生不支持文件夹上传,需用非标准webkitdirectory属性;仅Chrome、Edge(Chromium)、Safari(16.4+)支持,Firefox完全不支持;选中文件夹后递归列出所有子文件(不含子文件夹),File对象含webkitRelativePath可还原层级,但非标准且Firefox中为空。

html如何实现文件夹上传?完整代码步骤

HTML原生不支持文件夹上传,input[type="file"] 默认只传文件

浏览器对 input[type="file"] 的文件夹支持依赖于 webkitdirectory 非标准属性,且仅在 Chrome、Edge(Chromium 内核)和 Safari(16.4+)中可用。Firefox 完全不支持,且该属性无法触发传统“选择文件夹”对话框——它实际是让用户选择一个文件夹后,递归列出其**所有子文件(不含子文件夹本身)**。

常见错误现象:event.target.files 为空或只返回根目录下几个文件,但深层嵌套的文件没出现;或者开发者误以为能拿到文件夹路径,其实 File 对象里只有 name(含相对路径)、size、lastModified,没有真实路径字段。

  • 必须显式添加 webkitdirectory 属性(注意前缀),directory 单独写无效
  • multiple 属性可选,但加上更稳妥(部分旧版 Chrome 要求同时存在)
  • 不能用 accept 过滤文件夹类型——它只对文件扩展名生效,对目录无意义
  • 用户看到的仍是“选择文件夹”提示,但底层行为是“展开并提交该目录下所有文件”

如何用 webkitdirectory 正确获取文件列表并保留层级信息

webkitdirectory 模式下,每个 File 对象的 webkitRelativePath 属性会返回从所选文件夹开始的相对路径(如 "src/js/main.js"),这是唯一能还原目录结构的依据。但该属性非标准,Firefox 中为 "",需降级处理。

实操建议:

立即学习“前端免费学习笔记(深入)”;

AgentGen — HTML to PDF & Image
AgentGen — HTML to PDF & Image

将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……

下载
  • 检查 event.target.files 是否有内容,再遍历:
    const files = event.target.files;
    for (let i = 0; i < files.length; i++) {
      const file = files[i];
      const path = file.webkitRelativePath || file.name; // 降级:无相对路径时只用文件名
    }
  • 不要依赖 file.path 或 file.fullPath —— 它们在现代浏览器中已被移除或始终为空
  • 若需构建树形结构,按 / 分割 webkitRelativePath,逐级生成路径前缀,再用 Map 或对象聚合
  • 注意性能:万级小文件会导致 FileList 构建慢、内存占用高,建议加 loading 提示并限制最大文件数(前端校验)

后端接收时如何解析多层路径并保存到对应目录

前端传来的只是扁平化的 File 列表,每个文件附带 webkitRelativePath。后端需自行按路径拆分、创建子目录、写入文件。关键点不在 HTML,而在服务端如何安全还原结构。

使用场景与风险:

  • Node.js(Express + multer):默认 multer 不解析路径,需自定义 storage.destination 函数,从 req.file.originalname 提取相对路径并 fs.mkdirSync(..., { recursive: true })
  • Python(Flask):request.files.getlist("file") 获取全部,遍历每个 file.filename(即 webkitRelativePath),用 os.path.dirname() 提取父目录并 os.makedirs()
  • ⚠️ 严重安全风险:绝对禁止直接拼接 webkitRelativePath 到服务器路径(如 /uploads/ + file.filename),攻击者可构造 ../../../etc/passwd 绕过。必须先标准化路径:path.resolve(uploadDir, path.normalize(file.webkitRelativePath)),再校验是否仍在 uploadDir 下
  • PHP($_FILES):同理,$_FILES['file']['name'] 是相对路径,需用 realpath() 和 dirname() 做白名单校验

替代方案:为什么多数生产项目不用 webkitdirectory

真正需要完整文件夹上传的业务(如静态网站部署、设计稿批量提交),几乎都弃用原生方案,改用基于 WebkitDirectory 的封装库或桌面客户端桥接,因为兼容性、安全性、体验三者不可兼得。

更可行的做法:

  • 用 dropzone.js 或 uppy.io —— 它们内部检测 webkitdirectory 支持,并 fallback 到 ZIP 上传(用户手动压缩文件夹,前端解压再上传)
  • Electron / Tauri 桌面应用:直接调用系统 API 读取目录树,无浏览器限制
  • WebDAV 协议:后端启用 WebDAV,前端用 webdav-client 库递归 PUT,但需服务端额外配置
  • 最简单兜底:明确提示“请将文件夹压缩为 ZIP 后上传”,用 JSZip 在前端解压并提取路径,可控性更高

容易被忽略的一点:即使浏览器支持 webkitdirectory,用户也可能禁用 JavaScript、用旧版浏览器、或在 iOS Safari 上完全不可用——任何依赖它的功能都必须有明确的降级文案和操作指引。

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

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

热门AI工具

更多
SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

豆包大模型

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

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

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

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

WorkBuddy

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

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

7955

2023.06.14

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

4352

2023.06.21

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

4010

2023.07.31

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

4039

2023.08.01

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

5399

2023.08.11

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

3961

2023.08.11

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

3789

2023.08.31

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

3228

2023.09.01

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

0

2026.11.20

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
GDB 17.2 官方文档集合
GDB 17.2 官方文档集合

共0课时 | 0人学习

Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 247人学习

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

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