Przejdź do głównej zawartości

Dekodowanie i modyfikacja jako multipart/form-data

HTTP multipart/form-data to format danych składający się z wielu części, często używany w żądaniach klient-serwer z przesyłaniem plików.

W formacie multipart/form-data każdy element formularza składa się z niezależnej części, a części są rozdzielane boundary. Każda część może zawierać nagłówek z powiązaną treścią, np. tekst, dane binarne itd. Nagłówki zwykle zawierają słowa kluczowe takie jak Content-Disposition i Content-Type opisujące typ, nazwę i kodowanie części, a ciałem są właściwe dane.

Poniżej przykład formatu danych 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--

Powyższy przykład pokazuje żądanie multipart/form-data zawierające dwa elementy formularza: text i image. Element text to zwykły tekst, natomiast element image zawiera plik o nazwie example.png. Dane tekstu i pliku znajdują się w różnych częściach, a każda część ma własne content-type, nazwę i treść.

Podczas przepisywania name i filename w regułach przepisywania odpowiadają name i filename z Content-Disposition. Hodor obsługuje wyłącznie modyfikację name i powiązanej treści.