📌Getting started
🔌Routing
🗜️Compression
🖼️ View/Templates
📁File Server
🌎Localization
🛡️Security
🚀Responses
📥
Requests
💉Dependency Injection
Forms
Form, post data and uploaded files can be retrieved using the following Context's methods.
1
// FormValueDefault returns a single parsed form value by its "name",
2
// including both the URL field's query parameters and the POST or PUT form data.
3
//
4
// Returns the "def" if not found.
5
FormValueDefault(name string, def string) string
6
// FormValue returns a single parsed form value by its "name",
7
// including both the URL field's query parameters and the POST or PUT form data.
8
FormValue(name string) string
9
// FormValues returns the parsed form data, including both the URL
10
// field's query parameters and the POST or PUT form data.
11
//
12
// The default form's memory maximum size is 32MB, it can be changed by the
13
// `iris.WithPostMaxMemory` configurator at
14
// main configuration passed on `app.Run`'s second argument.
15
//
16
// NOTE: A check for nil is necessary.
17
FormValues() map[string][]string
18
19
// PostValueDefault returns the parsed form data from POST, PATCH,
20
// or PUT body parameters based on a "name".
21
//
22
// If not found then "def" is returned instead.
23
PostValueDefault(name string, def string) string
24
// PostValue returns the parsed form data from POST, PATCH,
25
// or PUT body parameters based on a "name"
26
PostValue(name string) string
27
// PostValueTrim returns the parsed form data from POST, PATCH,
28
// or PUT body parameters based on a "name", without trailing spaces.
29
PostValueTrim(name string) string
30
// PostValueInt returns the parsed form data from POST, PATCH,
31
// or PUT body parameters based on a "name", as int.
32
//
33
// If not found returns -1 and a non-nil error.
34
PostValueInt(name string) (int, error)
35
// PostValueIntDefault returns the parsed form data from POST, PATCH,
36
// or PUT body parameters based on a "name", as int.
37
//
38
// If not found returns or parse errors the "def".
39
PostValueIntDefault(name string, def int) int
40
// PostValueInt64 returns the parsed form data from POST, PATCH,
41
// or PUT body parameters based on a "name", as float64.
42
//
43
// If not found returns -1 and a no-nil error.
44
PostValueInt64(name string) (int64, error)
45
// PostValueInt64Default returns the parsed form data from POST, PATCH,
46
// or PUT body parameters based on a "name", as int64.
47
//
48
// If not found or parse errors returns the "def".
49
PostValueInt64Default(name string, def int64) int64
50
// PostValueInt64Default returns the parsed form data from POST, PATCH,
51
// or PUT body parameters based on a "name", as float64.
52
//
53
// If not found returns -1 and a non-nil error.
54
PostValueFloat64(name string) (float64, error)
55
// PostValueInt64Default returns the parsed form data from POST, PATCH,
56
// or PUT body parameters based on a "name", as float64.
57
//
58
// If not found or parse errors returns the "def".
59
PostValueFloat64Default(name string, def float64) float64
60
// PostValueInt64Default returns the parsed form data from POST, PATCH,
61
// or PUT body parameters based on a "name", as bool.
62
//
63
// If not found or value is false, then it returns false, otherwise true.
64
PostValueBool(name string) (bool, error)
65
// PostValues returns all the parsed form data from POST, PATCH,
66
// or PUT body parameters based on a "name" as a string slice.
67
//
68
// The default form's memory maximum size is 32MB, it can be changed by the
69
// `iris.WithPostMaxMemory` configurator at
70
// main configuration passed on `app.Run`'s second argument.
71
PostValues(name string) []string
72
// FormFile returns the first uploaded file that received from the client.
73
//
74
// The default form's memory maximum size is 32MB, it can be changed by the
75
// `iris.WithPostMaxMemory` configurator at
76
// main configuration passed on `app.Run`'s second argument.
77
FormFile(key string) (multipart.File, *multipart.FileHeader, error)
Copied!
Multipart/Urlencoded Form
1
func main() {
2
app := iris.Default()
3
4
app.Post("/form_post", func(ctx iris.Context) {
5
message := ctx.FormValue("message")
6
nick := ctx.FormValueDefault("nick", "anonymous")
7
8
ctx.JSON(iris.Map{
9
"status": "posted",
10
"message": message,
11
"nick": nick,
12
})
13
})
14
15
app.Listen(":8080")
16
}
Copied!
Another example: query + post form
1
POST /post?id=1234&page=1 HTTP/1.1
2
Content-Type: application/x-www-form-urlencoded
3
4
name=manu&message=this_is_great
Copied!
1
func main() {
2
app := iris.Default()
3
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.
10
11
app.Logger().Infof("id: %s; page: %s; name: %s; message: %s",
12
id, page, name, message)
13
})
14
15
app.Listen(":8080")
16
}
Copied!
1
id: 1234; page: 1; name: manu; message: this_is_great
Copied!
Upload files
Iris Context offers a helper for uploading files (saving files to host system's hard disk from request file data). Read more about the
Context.UploadFormFiles method below.UploadFormFiles uploads any received file(s) from the client to the system physical location "destDirectory".
The second optional argument "before" gives caller the chance to modify the *miltipart.FileHeader before saving to the disk, it can be used to change a file's name based on the current request, all FileHeader's options can be changed. You can ignore it if you don't need to use this capability before saving a file to the disk.
Note that it doesn't check if request body streamed.
Returns the copied length as int64 and a not nil error if at least one new file can't be created due to the operating system's permissions or
net/http.ErrMissingFile if no file received.If you want to receive & accept files and manage them manually you can use the
Context.FormFile instead and create a copy function that suits your needs, the below is for generic usage.The default form's memory maximum size is 32MB, it can be changed by the
iris#WithPostMaxMemory configurator at main configuration passed on app.Run's second argument.1
UploadFormFiles(destDirectory string,
2
before ...func(Context, *multipart.FileHeader)) (n int64, err error)
Copied!
Example Code:
1
const maxSize = 5 << 20 // 5MB
2
3
func main() {
4
app := iris.Default()
5
app.Post("/upload", iris.LimitRequestBodySize(maxSize), func(ctx iris.Context) {
6
//
7
// UploadFormFiles
8
// uploads any number of incoming files ("multiple" property on the form input).
9
//
10
11
// The second, optional, argument
12
// can be used to change a file's name based on the request,
13
// at this example we will showcase how to use it
14
// by prefixing the uploaded file with the current user's ip.
15
ctx.UploadFormFiles("./uploads", beforeSave)
16
})
17
18
app.Listen(":8080")
19
}
20
21
func beforeSave(ctx iris.Context, file *multipart.FileHeader) {
22
ip := ctx.RemoteAddr()
23
// make sure you format the ip in a way
24
// that can be used for a file name (simple case):
25
ip = strings.Replace(ip, ".", "_", -1)
26
ip = strings.Replace(ip, ":", "_", -1)
27
28
// you can use the time.Now, to prefix or suffix the files
29
// based on the current time as well, as an exercise.
30
// i.e unixTime := time.Now().Unix()
31
// prefix the Filename with the $IP-
32
// no need for more actions, internal uploader will use this
33
// name to save the file into the "./uploads" folder.
34
file.Filename = ip + "-" + file.Filename
35
}
Copied!
How to
curl:1
curl -X POST http://localhost:8080/upload \
2
-F "files[][email protected]/myfile.zip" \
3
-F "files[][email protected]/mysecondfile.zip" \
4
-H "Content-Type: multipart/form-data"
Copied!
More examples can be found at https://github.com/kataras/iris/tree/master/_examples/request-body and https://github.com/kataras/iris/tree/master/_examples/file-server.
Last modified 1yr ago
Export as PDF
Copy link