表单，post的数据和上传的文件可以使用下面的 Context 的方法获取。

  1. // FormValueDefault 返回一个根据名字获取的form的值，
  2. // 其中可能是URL的查询参数和POST或者PUT的数据，
  3. // 如果没有找到返回 def 指定的值。
  4. FormValueDefault(name string, def string) string
  6. // FormValue 返回一个根据名字获取的form的值，
  7. // 其中可能是URL的查询参数和POST或者PUT的数据，
  8. FormValue(name string) string
  10. //  FormValues 返回一个根据名字获取的form的值，
  11. // 其中可能是URL的查询参数和POST或者PUT的数据，
  12. // 默认的form的内存最大尺寸是32MB，
  13. // 这个可以通过在 app.Run() 的第二个参数传入 iris.WithPostMaxMemory 配置器来改变这个大小。
  14. // 记住：检查返回值是否为 nil 是有必要的！
  15. FormValues() map[string][]string
  17. // PostValueDefault 返回通过解析POST，PATCH或者PUT请求体参数，指定名字对应的值。
  18. // 如果没有找到这个名字则返回 def 指定的默认值。
  19. PostValueDefault(name string, def string) string
  21. // PostValue 返回通过解析POST，PATCH或者PUT请求体参数，指定名字对应的值。
  22. PostValue(name string) string
  24. // PostValueTrim 返回通过解析POST，PATCH或者PUT请求体参数，
  25. // 指定名字对应的没有前后空格的值。
  26. PostValueTrim(name string) string
  28. // PostValueInt 返回通过解析POST，PATCH或者PUT请求体参数，
  29. // 指定名字对应的int的值。
  30. // 如果没有找到name对应的值，则返回-1和一个非nil的错误。
  31. PostValueInt(name string) (int, error)
  33. // PostValueIntDefault  返回通过解析POST，PATCH或者PUT请求体参数，
  34. // 指定名字对应的int的值。
  35. // 如果没有找到name对应的值，则 def 指定的默认值。
  36. PostValueIntDefault(name string, def int) int
  38. // PostValueInt64 返回通过解析POST，PATCH或者PUT请求体参数，
  39. // 指定名字对应的int64的值。
  40. // 如果没有找到name对应的值，则返回-1和一个非nil的错误。
  41. PostValueInt64(name string) (int64, error)
  43. // PostValueInt64Default  返回通过解析POST，PATCH或者PUT请求体参数，
  44. // 指定名字对应的int64的值。
  45. // 如果没有找到name对应的值，则 def 指定的默认值。
  46. PostValueInt64Default(name string, def int64) int64
  48. // PostValueFloat64 返回通过解析POST，PATCH或者PUT请求体参数，
  49. // 指定名字对应的float6464的值。
  50. // 如果没有找到name对应的值，则返回-1和一个非nil的错误。
  51. PostValueFloat64(name string) (float64, error)
  53. // PostValueFloat64Default  返回通过解析POST，PATCH或者PUT请求体参数，
  54. // 指定名字对应的float64的值。
  55. // 如果没有找到name对应的值，则 def 指定的默认值。
  56. PostValueFloat64Default(name string, def float64) float64
  58. // PostValueBool  返回通过解析POST，PATCH或者PUT请求体参数，
  59. // 指定名字对应的bool的值。
  60. // 如果没有找到name对应的值，则返回false和一个非nil的错误。
  61. PostValueBool(name string) (bool, error)
  63. // PostValues  返回通过解析POST，PATCH或者PUT请求体参数，
  64. // 指定名字对应的[]string的值。
  65. // 默认的form的内存最大尺寸是32MB，
  66. // 这个可以通过在 app.Run() 的第二个参数传入 iris.WithPostMaxMemory 配置器来改变这个大小。
  67. // 记住：检查返回值是否为 nil 是有必要的！
  68. PostValues(name string) []string
  70. // FormFile 返回第一个从客户端上传的文件。
  71. // 默认的form的内存最大尺寸是32MB，
  72. // 这个可以通过在 app.Run() 的第二个参数传入 iris.WithPostMaxMemory 配置器来改变这个大小。
  73. // 记住：检查返回值是否为 nil 是有必要的！
  74. FormFile(key string) (multipart.File, *multipart.FileHeader, error)

Multipart/Urlencoded Form

  1. func main() {
  2.     app := iris.Default()
  4.     app.Post("/form_post", func(ctx iris.Context) {
  5.         message := ctx.FormValue("message")
  6.         nick := ctx.FormValueDefault("nick", "anonymous")
  8.         ctx.JSON(iris.Map{
  9.             "status":  "posted",
  10.             "message": message,
  11.             "nick":    nick,
  12.         })
  13.     })
  15.     app.Run(iris.Addr(":8080"))
  16. }

另一个例子：query + post form

  1. POST /post?id=1234&page=1 HTTP/1.1
  2. Content-Type: application/x-www-form-urlencoded
  4. name=manu&message=this_is_great
  1. func main() {
  2.     app := iris.Default()
  4.     app.Post("/post", func(ctx iris.Context) {
  5.         id := ctx.URLParam("id")
  6.         page := ctx.URLParamDefault("page", "0")
  7.         name := ctx.FormValue("name")
  8.         message := ctx.FormValue("message")
  9.         // or `ctx.PostValue` for POST, PUT & PATCH-only HTTP Methods.
  11.         app.Logger().Infof("id: %s; page: %s; name: %s; message: %s",
  12.             id, page, name, message)
  13.     })
  15.     app.Run(iris.Addr(":8080"))
  16. }
  1. id: 1234; page: 1; name: manu; message: this_is_great

上传文件

Context 提供了上传一个用于上传文件的助手(从请求的文件数据中保存文件到主机系统的硬盘上)。阅读下面的 Context.UploadFormFiles 方法。

  1. UploadFormFiles(destDirectory string, 
  2.         before ...func(Context, *multipart.FileHeader)) (n int64, err error)

UploadFromFile 上载任何从客户端获取的文件到系统物理 destDirctory 位置。

第二个参数 before 给定可调用的函数，这些函数可以在保存到磁盘之前改变 *miltipart.FileHeader，它可以用来基于当前请求改变文件的名字，并且所有的 FileHeader 的选项都可以改变。如果你不需要在保存文件到硬盘之前使用这个特性，你可以忽略这个参数。

请注意，它不会检查请求正文是否流式传输。

返回复制的长度的int64值， 和由于操作系统权限导致一个新文件无法创建的非 nil的错误, 或者由于没有文件获取而返回 net/http.ErrMissingFile 错误。

如果你想接收并接受文件，并且手动管理它们，你可以使用 Context.FormFile，创建一个复制的函数，满足你的需求，下面是通用用法。

默认的form的内存限制是32MB，你通过在主配置时传递 iris.WithPostMaxMemory 配置器到 app.Run 的第二个参数来改变这个限制。

示例代码：

  1. func main() {
  2.     app := iris.Default()
  3.     app.Post("/upload", iris.LimitRequestBodySize(maxSize), func(ctx iris.Context) {
  4.         //
  5.         // UploadFormFiles
  6.         // uploads any number of incoming files ("multiple" property on the form input).
  7.         //
  9.         // The second, optional, argument
  10.         // can be used to change a file's name based on the request,
  11.         // at this example we will showcase how to use it
  12.         // by prefixing the uploaded file with the current user's ip.
  13.         ctx.UploadFormFiles("./uploads", beforeSave)
  14.     })
  16.     app.Run(iris.Addr(":8080"))
  17. }
  19. func beforeSave(ctx iris.Context, file *multipart.FileHeader) {
  20.     ip := ctx.RemoteAddr()
  21.     // make sure you format the ip in a way
  22.     // that can be used for a file name (simple case):
  23.     ip = strings.Replace(ip, ".", "_", -1)
  24.     ip = strings.Replace(ip, ":", "_", -1)
  26.     // you can use the time.Now, to prefix or suffix the files
  27.     // based on the current time as well, as an exercise.
  28.     // i.e unixTime :=    time.Now().Unix()
  29.     // prefix the Filename with the $IP-
  30.     // no need for more actions, internal uploader will use this
  31.     // name to save the file into the "./uploads" folder.
  32.     file.Filename = ip + "-" + file.Filename
  33. }