Passa al contenuto principale

Decodifica e modifica come multipart/form-data

HTTP multipart/form-data è un formato di dati composto da più parti, spesso usato per richieste client-server con caricamento di file.

Nel formato dati multipart/form-data, ogni elemento del form consiste di una part indipendente, con le parti separate da un boundary. Ogni part può includere un header con contenuto associato, come testo, dati binari, ecc. Gli header contengono solitamente parole chiave come Content-Disposition e Content-Type per descrivere tipo, nome e codifica della part, e il corpo è il dato effettivamente trasportato.

Quello che segue è un esempio di formato dati multipart/form-data:

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--

L'esempio sopra mostra una richiesta multipart/form-data contenente due elementi del form: text e image. L'elemento del form text è testo semplice, mentre l'elemento del form image contiene un file di nome example.png. Il testo e i dati del file si trovano in parti diverse, con ogni part che ha il proprio content-type, nome e contenuto del corpo.

Durante la riscrittura, name e filename nelle regole di riscrittura corrispondono a name e filename di Content-Disposition. Hodor supporta solo la modifica di name e del contenuto corrispondente.