4.2. Champ d'en-tête Content-Disposition pour chaque partie
4.2. Champ d'en-tête Content-Disposition pour chaque partie
Chaque partie doit contenir un champ d'en-tête Content-Disposition [RFC2183] dont le type de disposition est "form-data" (MUST). Le champ d'en-tête Content-Disposition doit également contenir un paramètre supplémentaire "name" (MUST) ; la valeur du paramètre "name" est le nom de champ d'origine issu du formulaire (éventuellement encodé ; voir la section 5.1). Par exemple, une partie peut contenir un champ d'en-tête tel que le suivant, le corps de la partie contenant les données de formulaire du champ "user" :
Content-Disposition: form-data; name="user"
Pour les données de formulaire qui représentent le contenu d'un fichier, un nom pour le fichier devrait également être fourni (SHOULD), au moyen d'un paramètre "filename" du champ d'en-tête Content-Disposition. Le nom de fichier n'est pas obligatoire dans les cas où il n'est pas disponible, ou bien où il est dépourvu de sens ou privé ; cela peut se produire, par exemple, lorsque la sélection ou le glisser-déposer est utilisé, ou lorsque le contenu des données de formulaire est transmis directement en flux depuis un appareil.
Si un paramètre "filename" est fourni, les exigences de la section 2.3 de la [RFC2183] concernant le "receiving MUA" (c'est-à-dire l'agent utilisateur de messagerie destinataire) s'appliquent également aux destinataires de multipart/form-data : n'utilisez pas le nom de fichier aveuglément, vérifiez-le et modifiez-le si nécessaire pour qu'il corresponde aux conventions du système de fichiers local le cas échéant, et n'utilisez pas les informations de chemin de répertoire qui peuvent être présentes.
Dans la plupart des types multipart, les champs d'en-tête MIME de chaque partie sont limités à US-ASCII ; pour assurer la compatibilité avec ces systèmes, les noms de fichiers normalement visibles par les utilisateurs peuvent être encodés au moyen de la méthode d'encodage par pourcentage décrite à la section 2 (MAY), à la manière dont une URI "file:" [URI-SCHEME] pourrait être encodée.
REMARQUE : la méthode d'encodage décrite dans la [RFC5987], qui ajouterait un paramètre "filename*" au champ d'en-tête Content-Disposition, ne doit pas être utilisée (MUST NOT).
Certains systèmes couramment déployés utilisent multipart/form-data avec des noms de fichiers encodés directement, y compris des octets hors de la plage US-ASCII. L'encodage utilisé pour les noms de fichiers est généralement UTF-8, bien que les formulaires HTML utilisent le charset associé au formulaire.