Content-Encoding: |
Contient l'encodage |
|---|---|
| HTTP | Entêtes |
Syntaxe
| Content-Encoding: gzip | Encodage simple |
| Content-Encoding: compress | |
| Content-Encoding: deflate | |
| Content-Encoding: identity | |
| Content-Encoding: br | |
| Content-Encoding: gzip, identity | Encodage multiple |
| Content-Encoding: deflate, gzip |
Paramètres
| Nom | Description |
|---|---|
| br | Ce paramètre permet d'indiquer un format utilisant l'algorithme de Brotli. |
| compress | Ce paramètre permet d'indiquer un format utilisant l'algorithme de LZW (Lempel-Ziv-Welch). Le nom de la valeur provient du programme de compression UNIX, ayant mise en oeuvre cet algorithme. Comme le programme de compression, ayant disparu de la plupart des distributions UNIX, ce codage de contenu n'est pas utilisé par de nombreux navigateurs Web aujourd'hui, en partie à cause d'un problème de brevet (il a expiré en 2003). |
| deflate | Ce paramètre permet d'indiquer l'algorithme de compression de dégonflage (défini dans RFC 1951) utilisant la structure zlib (définie dans RFC 1950). |
| gzip | Ce paramètre permet d'indiquer un format utilisant le codage LZ77 (Lempel-Ziv 1977), avec un CRC en 32 bits. Il s'agit du format d'origine du programme gzip du système d'exploitation UNIX. La norme HTTP/1.1 recommande également que les serveurs prenant en charge cet encodage de contenu reconnaissent x-gzip comme un alias, à des fins de compatibilité. |
| identity | Ce paramètre permet d'indiquer la fonction d'identité (c'est-à-dire, aucune compression ou modification). Ce jeton, sauf indication contraire explicite, est toujours considéré comme acceptable. |
Description
Ce champ d'entête permet d'indiquer la compression pour le type de média. Lorsqu'elle est présente, cette valeur indique quels codages ont été appliqués au corps de l'entité.
Remarques
- Le champ d'entête Content-Encoding: indique quels codages de contenu ont été appliqués à la représentation, au-delà de ceux inhérents au type de média, et donc quels mécanismes de décodage doivent être appliqués afin d'obtenir des données dans le type de média référencé par le champ d'en-tête Content-Type. Le champ d'entête Content-Encoding: est principalement utilisé pour permettre la compression des données d'une représentation sans perdre l'identité de son type de support sous-jacent.
- Si un ou plusieurs codages ont été appliqués à une représentation, l'expéditeur ayant appliqué les codages doit générer un champ d'entête Content-Encoding: répertoriant les codages de contenu dans l'ordre dans lequel ils ont été appliqués. Des informations supplémentaires sur les paramètres de codage peuvent être fournies par d'autres champs d'entête non définis par cette spécification.
- Contrairement au Transfer-Encoding:, les codages répertoriés dans Content-Encoding: sont une caractéristique de la représentation; la représentation est définie en termes de format codée, et toutes les autres méta-données concernant la représentation concernent le format codée, sauf indication contraire dans la définition des méta-données. En règle générale, la représentation n'est décodée que juste avant le rendu ou une utilisation analogue.
- Si le type de média comprend un codage inhérent, tel qu'un format de données étant toujours compressé, ce codage ne sera pas retraité dans Content-Encoding: même s'il se trouve qu'il s'agit du même algorithme que l'un des codages de contenu. Un tel codage de contenu ne serait répertorié que si, pour une raison étrange, il était appliqué une deuxième fois pour former la représentation. De même, un serveur d'origine peut choisir de publier les mêmes données que plusieurs représentations qui diffèrent uniquement selon que le codage est défini dans le cadre de Content-Type: ou Content-Encoding:, car certains agents utilisateurs se comporteront différemment dans la gestion de chaque réponse (par exemple, ouvrez une boîte de dialogue «Enregistrer sous...» au lieu de la décompression et du rendu automatiques du contenu).
- Un serveur d'origine peut répondre avec un code d'état de 415 Unsupported Media Type si une représentation dans le message de demande a un codage de contenu n'étant pas acceptable.
Dernière mise à jour : Vendredi, le 10 janvier 2020