### 单文件上传
参考问题 [#774](https://github.com/gin-gonic/gin/issues/774),细节 [example code](https://github.com/gin-gonic/gin/tree/master/examples/upload-file/single)
慎用 `file.Filename` ,参考 [Content-Disposition on MDN](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition#Directives) 和 [#1693](https://github.com/gin-gonic/gin/issues/1693)
> 上传文件的文件名可以由用户自定义,所以可能包含非法字符串,为了安全起见,应该由服务端统一文件名规则
```
func main() {
router := gin.Default()
// 给表单限制上传大小 (默认 32 MiB)
// router.MaxMultipartMemory = 8 << 20 // 8 MiB
router.POST("/upload", func(c *gin.Context) {
// 单文件
file, _ := c.FormFile("file")
log.Println(file.Filename)
// 上传文件到指定的路径
// c.SaveUploadedFile(file, dst)
c.String(http.StatusOK, fmt.Sprintf("'%s' uploaded!", file.Filename))
})
router.Run(":8080")
}
```
`curl` 测试:
```
curl -X POST http://localhost:8080/upload \
-F "file=@/Users/appleboy/test.zip" \
-H "Content-Type: multipart/form-data"
```
### 多文件上传
详细示例:[example code](https://github.com/gin-gonic/gin/tree/master/examples/upload-file/multiple)
```
func main() {
router := gin.Default()
// 给表单限制上传大小 (默认 32 MiB)
// router.MaxMultipartMemory = 8 << 20 // 8 MiB
router.POST("/upload", func(c *gin.Context) {
// 多文件
form, _ := c.MultipartForm()
files := form.File["upload[]"]
for _, file := range files {
log.Println(file.Filename)
// 上传文件到指定的路径
// c.SaveUploadedFile(file, dst)
}
c.String(http.StatusOK, fmt.Sprintf("%d files uploaded!", len(files)))
})
router.Run(":8080")
}
```
`curl` 测试:
```
curl -X POST http://localhost:8080/upload \
-F "upload[]=@/Users/appleboy/test1.zip" \
-F "upload[]=@/Users/appleboy/test2.zip" \
-H "Content-Type: multipart/form-data"
```
- 简介
- 安装
- 快速入门
- 代码示例
- 使用 GET, POST, PUT, PATCH, DELETE, OPTIONS
- 获取路径中的参数
- 获取Get参数
- 获取Post参数
- Get + Post 混合
- 上传文件
- 路由分组
- 无中间件启动
- 使用中间件
- 写日志文件
- 自定义日志格式
- 模型绑定和验证
- 自定义验证器
- 只绑定Get参数
- 绑定Get参数或者Post参数
- 绑定uri
- 绑定HTML复选框
- 绑定Post参数
- XML、JSON、YAML和ProtoBuf 渲染(输出格式)
- 设置静态文件路径
- 返回第三方获取的数据
- HTML渲染
- 多个模板文件
- 重定向
- 自定义中间件
- 使用BasicAuth()(验证)中间件
- 中间件中使用Goroutines
- 自定义HTTP配置
- 支持Let's Encrypt证书
- Gin运行多个服务
- 优雅重启或停止
- 构建包含模板的二进制文件
- 使用自定义结构绑定表单数据
- 将请求体绑定到不同的结构体中
- HTTP/2 服务器推送
- 自定义路由日志的格式
- 设置并获取cookie
- 测试
- 用户