vapor-docs/3.0/docs/http/multipart.md

Multipart Forms

Multipart is a module that is primarily used with Forms. Multipart is used for complex forms containing one or more files, input fields and other HTML form data.

Extracting from a request

MultipartForm is a type of Content and can be extracted like any type of Content.

let form = try MultipartForm.decode(from: request) // Future<MultipartForm>

A future is returned because of streaming/reactive body parsing.

Parsing a multipart form

Multipart forms can be parsed using MultipartParser provided a body and boundary to read.

let form = try MultipartParser(body: httpBody, boundary: boundaryBytes).parse()

Reading forms

The parsed form is an array of Part instances. Each of them contains data and headers.

You can read a part using either manually or using the MultipartForm's helpers.

let pictureData = try form.getFile(named: "profile-picture")

let newPassword = try form.getString(named: "password")