Ga naar hoofdinhoud

Decoderen en wijzigen als multipart/form-data

HTTP multipart/form-data is een gegevensformaat dat bestaat uit meerdere delen, vaak gebruikt voor client-serververzoeken met bestandsuploads.

In het multipart/form-data-formaat bestaat elk formulieritem uit een onafhankelijk part, waarbij de parts door een boundary worden gescheiden. Elk part kan een header met bijbehorende inhoud bevatten, zoals tekst, binaire gegevens, enz. De headers bevatten doorgaans keywords als Content-Disposition en Content-Type om het type, de naam en de encoding van het part te beschrijven; de body is de werkelijk meegegeven gegevens.

Hieronder een voorbeeld van het multipart/form-data-formaat:

POST /submit-form HTTP/1.1
Host: example.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Length: 248

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="text"

Hello World!
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="image"; filename="example.png"
Content-Type: image/png

(binary data)
------WebKitFormBoundary7MA4YWxkTrZu0gW--

Het bovenstaande voorbeeld toont een multipart/form-data-verzoek met twee formulieritems: tekst en afbeelding. Het tekstitem is platte tekst, terwijl het afbeeldingsitem een bestand met de naam example.png bevat. De tekst en de bestandsgegevens bevinden zich in verschillende parts, elk met zijn eigen content-type, naam en body-inhoud.

Bij herschrijven komen name en filename in de herschrijfregels overeen met de name en filename van Content-Disposition. Hodor ondersteunt alleen het wijzigen van name en de bijbehorende inhoud.