Passa al contenuto principale

4.2. Campo di intestazione Content-Disposition per ogni parte

4.2. Campo di intestazione Content-Disposition per ogni parte​

Ogni parte deve contenere un campo di intestazione Content-Disposition [RFC2183] in cui il tipo di disposizione è "form-data" (MUST). Il campo di intestazione Content-Disposition deve contenere anche un parametro aggiuntivo "name" (MUST); il valore del parametro "name" è il nome del campo originale del modulo (eventualmente codificato; si veda la Sezione 5.1). Ad esempio, una parte potrebbe contenere un campo di intestazione come il seguente, con il corpo della parte che contiene i dati del modulo del campo "user":

Content-Disposition: form-data; name="user"

Per i dati del modulo che rappresentano il contenuto di un file, dovrebbe essere fornito anche un nome per il file, utilizzando un parametro "filename" del campo di intestazione Content-Disposition (SHOULD). Il nome del file non è obbligatorio nei casi in cui il nome del file non sia disponibile o sia privo di significato o privato; ciò può verificarsi, ad esempio, quando si utilizza la selezione o il trascinamento, oppure quando il contenuto dei dati del modulo viene trasmesso in streaming direttamente da un dispositivo.

Se viene fornito un parametro "filename", i requisiti della Sezione 2.3 della [RFC2183] per il "receiving MUA" (ossia il Mail User Agent ricevente) si applicano anche ai riceventi di multipart/form-data: non utilizzare ciecamente il nome del file, verificarlo ed eventualmente modificarlo per adeguarlo alle convenzioni del file system locale, se applicabile, e non utilizzare le informazioni sul percorso di directory che potrebbero essere presenti.

Nella maggior parte dei tipi multipart, i campi di intestazione MIME in ciascuna parte sono limitati a US-ASCII; per compatibilità con tali sistemi, i nomi di file normalmente visibili agli utenti possono essere codificati utilizzando il metodo di codifica percentuale della Sezione 2, seguendo il modo in cui potrebbe essere codificato un URI "file:" [URI-SCHEME] (MAY).

NOTA: il metodo di codifica descritto nella [RFC5987], che aggiungerebbe un parametro "filename*" al campo di intestazione Content-Disposition, non deve essere utilizzato (MUST NOT).

Alcuni sistemi comunemente diffusi utilizzano multipart/form-data con nomi di file codificati direttamente, inclusi ottetti al di fuori dell'intervallo US-ASCII. La codifica utilizzata per i nomi dei file è tipicamente UTF-8, sebbene i moduli HTML utilizzino il charset associato al modulo.