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.