Multipart 模块

Multipart 模块为 XScript 提供 multipart/form-data 表单数据处理功能,用于文件上传和表单解析。

功能特性

文件上传 - 处理文件上传请求

表单解析 - 解析 multipart 表单数据

多文件支持 - 同时上传多个文件

流式处理 - 大文件流式上传

文件过滤 - 文件类型和大小限制

临时存储 - 自动管理临时文件

创建 Multipart 数据 - 生成 multipart/form-data 用于发送请求

基本使用

引入模块

解析表单数据

保存上传文件

多文件上传

文件过滤

创建 Multipart 数据

当需要发送包含文件的 HTTP 请求时，可以使用 multipart.new() 创建 multipart 数据。

链式调用

Multipart 对象支持链式调用：

动态添加和删除

API 参考

解析方法

`multipart.parse(request, options)`

解析 multipart 请求。

参数:

request (Request) - HTTP 请求对象

options (object) - 配置选项

maxFileSize (number) - 最大文件大小(字节)

maxFiles (number) - 最大文件数量

allowedTypes (Array) - 允许的 MIME 类型

uploadDir (string) - 上传目录

返回: (Form) 表单对象

表单方法

`form.get(name)`

获取字段值。

`form.getFile(name)`

获取单个文件。

`form.getFiles(name)`

获取多个文件。

`form.getAllFiles()`

获取所有文件。

创建方法

`multipart.new()`

创建一个新的 Multipart 对象用于生成 multipart/form-data 数据。

返回: (Multipart) Multipart 对象

`multipart.addField(field, value)`

添加文本字段。

参数:

field (string) - 字段名

value (string) - 字段值

返回: (Multipart) 返回自身，支持链式调用

`multipart.addFile(field, filePath)`

添加文件字段。

参数:

field (string) - 字段名

filePath (string) - 文件路径

返回: (Multipart) 返回自身，支持链式调用

`multipart.delField(field)`

删除文本字段。

参数:

field (string) - 字段名

返回: (Multipart) 返回自身，支持链式调用

`multipart.delFile(field)`

删除文件字段。

参数:

field (string) - 字段名

返回: (Multipart) 返回自身，支持链式调用

`multipart.create()`

生成 multipart/form-data 格式的数据。

返回: (object) 包含以下属性的对象

content_type (string) - Content-Type 头的值

content (string) - multipart 数据内容

实际应用场景

头像上传

文档上传

图片批量上传

表单数据提交

最佳实践

文件大小限制 - 设置合理的文件大小限制

文件类型验证 - 检查文件类型防止恶意上传

唯一文件名 - 使用时间戳或 UUID 生成唯一文件名

安全存储 - 上传文件存储在 web 根目录外

临时文件清理 - 及时清理临时文件

病毒扫描 - 关键系统扫描上传文件

权限检查 - 验证用户上传权限

安全建议

文件名过滤 - 过滤特殊字符防止路径遍历

MIME 验证 - 不仅检查扩展名,也检查 MIME 类型

内容检查 - 验证文件真实类型

大小限制 - 防止 DoS 攻击

存储隔离 - 不同用户文件分开存储

multipart

Multipart 模块

功能特性

基本使用

引入模块

解析表单数据

保存上传文件

多文件上传

文件过滤

创建 Multipart 数据

链式调用

动态添加和删除

API 参考

解析方法

`multipart.parse(request, options)`

表单方法

`form.get(name)`

`form.getFile(name)`

`form.getFiles(name)`

`form.getAllFiles()`

创建方法

`multipart.new()`

`multipart.addField(field, value)`

`multipart.addFile(field, filePath)`

`multipart.delField(field)`

`multipart.delFile(field)`

`multipart.create()`

实际应用场景

头像上传

文档上传

图片批量上传

表单数据提交

最佳实践

安全建议

相关模块

发送文件到远程服务器

multipart

Multipart 模块#

功能特性#

基本使用#

引入模块#

解析表单数据#

保存上传文件#

多文件上传#

文件过滤#

创建 Multipart 数据#

链式调用#

动态添加和删除#

API 参考#

解析方法#

multipart.parse(request, options)#

表单方法#

form.get(name)#

form.getFile(name)#

form.getFiles(name)#

form.getAllFiles()#

创建方法#

multipart.new()#

multipart.addField(field, value)#

multipart.addFile(field, filePath)#

multipart.delField(field)#

multipart.delFile(field)#

multipart.create()#

实际应用场景#

头像上传#

文档上传#

图片批量上传#

表单数据提交#

最佳实践#

安全建议#

相关模块#

发送文件到远程服务器#

Multipart 模块

功能特性

基本使用

引入模块

解析表单数据

保存上传文件

多文件上传

文件过滤

创建 Multipart 数据

链式调用

动态添加和删除

API 参考

解析方法

`multipart.parse(request, options)`

表单方法

`form.get(name)`

`form.getFile(name)`

`form.getFiles(name)`

`form.getAllFiles()`

创建方法

`multipart.new()`

`multipart.addField(field, value)`

`multipart.addFile(field, filePath)`

`multipart.delField(field)`

`multipart.delFile(field)`

`multipart.create()`

实际应用场景

头像上传

文档上传

图片批量上传

表单数据提交

最佳实践

安全建议

相关模块

发送文件到远程服务器