Pular para o conteúdo principal

Decodificar e modificar como multipart/form-data

O multipart/form-data do HTTP é um formato de dados composto por múltiplas partes, frequentemente usado em requisições cliente-servidor com upload de arquivos.

No formato de dados multipart/form-data, cada item de formulário consiste em uma parte independente, com as partes separadas por um boundary. Cada parte pode incluir um header com o conteúdo associado, como texto, dados binários etc. Os headers normalmente contêm palavras-chave como Content-Disposition e Content-Type para descrever o tipo, o nome e a codificação da parte, e o body são os dados reais transportados.

A seguir está um exemplo do formato de dados 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--

O exemplo acima mostra uma requisição multipart/form-data contendo dois itens de formulário: text e image. O item de formulário text é texto simples, enquanto o item de formulário image contém um arquivo chamado example.png. Os dados de texto e de arquivo estão em partes diferentes, cada uma com seu próprio content-type, nome e conteúdo de body.

Na reescrita, name e filename nas regras de reescrita correspondem ao name e ao filename do Content-Disposition. O Hodor suporta apenas a modificação do name e do conteúdo correspondente.