86.txt

[4] [DFN[[RUBYB[[[内容符号化]]]@en[content coding]]]]は、
[[表現]]に対して適用されている、あるいは適用することができる[RUBYB[符号化変形]@en[encoding transformation]]です。
[[内容符号化]]は、[[圧縮]]などの変形に使うものです。 [SRC[>>434]]

* 仕様書

[REFS[
- [434] '''[CITE@en[RFC 7231 - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content]] ([TIME[2014-06-07 01:55:45 +09:00]] 版) <https://tools.ietf.org/html/rfc7231#section-3.1.2.1>'''
- [439] [CITE@en[RFC 7231 - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content]] ([TIME[2014-06-07 01:55:45 +09:00]] 版) <https://tools.ietf.org/html/rfc7231#section-3.1.2.2>
- [1] [CITE@en[RFC 7231 - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content]] ([TIME[2014-08-07 05:54:02 +09:00]] 版) <https://tools.ietf.org/html/rfc7231#section-8.4>
- [15] [CITE@en[RFC 7231 - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content]] ([TIME[2014-08-07 05:54:02 +09:00]] 版) <https://tools.ietf.org/html/rfc7231#appendix-A.4>
- [11] [CITE[Hypertext Transfer Protocol (HTTP) Parameters]] ([TIME[2014-06-13 18:52:05 +09:00]] 版) <http://www.iana.org/assignments/http-parameters/http-parameters.xhtml#content-coding>
- [21] [CITE@en[RFC 3261 - SIP: Session Initiation Protocol]] ([TIME[2014-08-15 14:48:03 +09:00]] 版) <http://tools.ietf.org/html/rfc3261#section-20.12>
- [24] [CITE@en[RFC 2295 - Transparent Content Negotiation in HTTP]] ([TIME[2014-08-31 19:36:42 +09:00]] 版) <http://tools.ietf.org/html/rfc2295#section-10.8>
- [35] [CITE@en[RFC 3229 - Delta encoding in HTTP]] ([TIME[2014-10-26 21:15:25 +09:00]] 版) <http://tools.ietf.org/html/rfc3229#section-10.7>
- [46] [CITE@en[RFC 7540 - Hypertext Transfer Protocol Version 2 (HTTP/2)]] ([TIME[2015-05-15 10:14:54 +09:00]] 版) <https://tools.ietf.org/html/rfc7540#section-10.6>
]REFS]

* 構文

[435] [[内容符号化]]の値は、[[字句]]で、[[大文字・小文字不区別]]です [SRC[>>434]]。

[417] [[内容符号化]]を表す値については、 >>3 をご覧ください。

;; [437] [[転送符号化]]とは違って、[[引数]]は指定できません。

[440] [[符号化]]についての追加の引数は、 [CODE(HTTP)@en[[[Content-Encoding:]]]]
とは別の[[ヘッダー]]によって指定できます [SRC[>>439]]。

;; [441] 現時点でそのような例はありません。

* 文脈

[438] [[内容符号化]]の値は、 [[HTTP]] の [CODE(HTTP)@en[[[Content-Encoding:]]]]
[[ヘッダー]]や、 [CODE(HTTP)@en[[[Accept-Encoding:]]]] [[ヘッダー]]、
[CODE(HTTP)@en[[[encoding]]]] [[異体属性]]で用います。

* 意味

[442] [[メッセージ本体]]の[[転送符号化]]を[[復号]]したものが、
[[内容符号化]]が(あれば)適用されているデータです。そこから
[CODE(HTTP)@en[[[Content-Encoding:]]]] の指定の逆により[[内容符号化]]を[[復号]]することで、
元々のデータが得られます。このデータが、 [CODE(HTTP)@en[[[Content-Type:]]]]
によって指定されたデータとなります。

[EG[
[443] 例えば、
[PRE(HTTP example code)[
Content-Type: text/html; charset=utf-8
Content-Encoding: gzip, deflate
Transfer-Encoding: deflate, chunked
]PRE]
... と[[ヘッダー]]に指定されている場合、[[メッセージ本体]]の [CODE(HTTP)@en[[[chunked]]]]
を[[復号]]し、 [CODE(HTTP)@en[[[deflate]]]] を[[復号]]し、
再度 [CODE(HTTP)@en[[[deflate]]]] を[[復号]]し、
[CODE(HTTP)@en[[[gzip]]]] を[[復号]]し、 [CODE(HTTP)@en[[[gzip]]]]
を[[復号]]すると、 [CODE(charset)@en[[[utf-8]]]] で[[符号化]]された
[[HTML文書]]が得られます。
]EG]

[444] [[転送符号化]]とは違って[[内容符号化]]は[[表現]]自体の特徴とされており、
他のメタデータも原則として[[内容符号化]]された状態に適用されるものです。
普通は[[内容符号化]]は[[レンダリング]]その他の利用の直前に[[復号]]されます。 [SRC[>>439]]

;; [445] [[転送符号化]]は[[串]]で[[復号]]や[[符号化]]することも認められていますが、
[[内容符号化]]はそのような使い方を想定しているものではないようです。

[446] データが常に[[圧縮]]される場合など、 [[MIME型]]自体に[[符号化]]が含まれている場合には、
これは[[内容符号化]]としては扱いません。 [SRC[>>439]]

[447] [[符号化]]が [CODE(HTTP)@en[[[Content-Type:]]]] に含まれるか
[CODE(HTTP)@en[[[Content-Encoding:]]]] で指定されるかによって動作が変わる
([[ダウンロード]]になったり、自動で展開されて[[レンダリング]]されたりする)
[[利用者エージェント]]があることから、[[起源鯖]]がその点のみ異なる同じデータの[[表現]]を提供することもあり得ます
[SRC[>>439]]。

* 送信者の処理モデル

[32] [[起源鯖]]が[[応答]]に適用する[[内容符号化]]の決定方法については、
[CODE(HTTP)@en[[[Accept-Encoding:]]]] を参照してください。

[33] [[利用者エージェント]]は[[要求]]に通常は[[内容符号化]]を適用しませんが、
仕様上[[要求]]に[[内容符号化]]を適用して [CODE(HTTP)@en[[[Content-Encoding:]]]]
を指定することが禁止されているわけではありません。

;; ただし対応していない[[鯖]]も少なくないでしょうから、事前に何らかの方法で対応する[[内容符号化]]を知っていないなら、
使うべきではないでしょう。

[34] [[透過内容折衝]]においては、 [[Apache]] の拡張である [CODE(HTTP)@en[[[encoding]]]]
[[異体属性]]で[[内容符号化]]が適用された[[異体]]であることを明示できます。

[36] [[鯖]]が[[差分符号化]]された[[応答]]を[[生成]]する時は、
適用する[[内容符号化]]の一覧 ([CODE(HTTP)@en[[[Content-Encoding:]]]] の値)
は[[差分符号化]]を使わない時に適用する[[内容符号化]]の一覧の[[接頭辞]]となっている[['''べきです''']] [SRC[>>35]]。

;; [37] この要件に従っていれば、[[受信者]]は[[キャッシュ]]している[[基底実現値]]に対してそのまま、または[[内容符号化]]を[[復号]]するだけで、新たに[[符号化]]することなく、
[[差分]]を適用できます。 [SRC[>>35]]

* 受信者の処理モデル

[448] [[起源鯖]]は、[[要求]]が受け付けられない[[内容符号化]]による[[表現]]を含んでいる場合に、
[CODE(HTTP)[[[415]]]] で[[応答]]して構いません [SRC[>>439]]。

[449] [[Webブラウザー]]は、 [CODE(HTTP)@en[[[gzip]]]] や [CODE(HTTP)@en[[[deflate]]]]
が[[内容符号化]]として用いられている場合、これを[[復号]]してから[[レンダリング]]します。

[49] [[Webブラウザー]]は [CODE(HTTP)@en[[[compress]]]] には対応していないようです。

[50] [[Webブラウザー]]は未対応の [CODE(HTTP)@en[[[Content-Encoding:]]]]
が指定された時、この[[ヘッダー]]を無視するようです。

;; 従って正しく表示されません。 [[MIME Sniffing]] の対象となる時は[[ダウンロード]]になるかもしれません。

;; [51] 常に[[ダウンロード]]とするか、エラーを表示するのが良さそうではありますが、
もしかすると不適切な設定のページがあって見れなくなってしまうのかもしれません。

[450] [[ダウンロード]]の際は、[[内容符号化]]を[[復号]]しないで保存するのが望ましいと考えられています。
かつて[[Webブラウザー]]は[[内容符号化]]を[[復号]]してから保存していたので、
しばしば [[tar]]+[[gz]] で配布されているファイルに [CODE(HTTP)@en[[[Content-Encoding:]]]]
が指定されており、勝手に展開される上に[[ファイル名]]に [CODE[.gz]]
が含まれたままになるような不都合が起きていました。

[38] [[クライアント]]が[[恒等]]でない[[内容符号化]]が適用された[[差分]]を受信した時は、
[FIG(list)[
- [39] [[蓄積された応答]] ([[基底実現値]]) と[[差分]]で適用されている[[内容符号化]]が同じなら、そのまま[[差分]]を適用します。 [SRC[>>35]]
- [40] [[蓄積された応答]] ([[基底実現値]]) と[[差分]]で適用されている[[内容符号化]]が異なるなら、[[蓄積された応答]]の[[内容符号化]]を[[復号]]して、[[差分]]の[[内容符号化]]と同じ状態にします。 [SRC[>>35]]
]FIG]

;; [41] [[内容符号化]]が異なる場合で、[[蓄積された応答]]側の[[内容符号化]]を[[復号]]しても[[差分]]の[[内容符号化]]と同じ状態にできない場合もあります。
その時は[[差分]]は適用できません。

[42] [[串]]や[[キャッシュ]]が[[基底実現値]]に[[差分]]を適用した結果を[[転送]]したり、
[[キャッシュ項目]]を使って後から[[転送]]したりするなら、
その [CODE(HTTP)@en[[[Content-Encoding:]]]] の値は[[差分]]の[[応答]]
[CODE(HTTP)@en[[[Content-Encoding:]]]] と同じとし、
適用される[[内容符号化]]も同じ状態としなければ[['''なりません''']] [SRC[>>35]]。

;; [43] これらの制約は、[[実体タグ]]が[[実現値]] (すなわち、[[内容符号化]]の適用後)
に関する値であることに由来しています。

* 内容符号化の値の一覧

[3] 次の値が使われていたり、提案されたりしています。
[FIG(list)[
,[CODE(HTTP)@en[[[7bit]]]],,非標準
,[CODE(HTTP)@en[[[8bit]]]],,非標準
,[CODE(HTTP)@en[[[aws-chunked]]]]
,[CODE(HTTP)@en[[[base64]]]],,非標準
,[CODE(HTTP)@en[[[binary]]]],,非標準
,[CODE(HTTP)@en[[[bzip]]]],[[bzip]],非標準
,[CODE(HTTP)@en[[[x-bzip]]]],[[bzip]],非標準
,[CODE(HTTP)@en[[[bzip2]]]],[[bzip]],非標準
,[CODE(HTTP)@en[[[x-bzip2]]]],[[bzip]],非標準
,[CODE(HTTP)@en[[[compress]]]],[[compress]],[[IETF]] [[原案標準]],"[[RFC 2616]], [[IANAREG]]"
,[CODE(HTTP)@en[[[x-compress]],[[compress]],[[IETF]] [[情報提供RFC]] → [CODE(HTTP)@en[[[compress]]]],[[RFC 1945]]
,[CODE(HTTP)@en[[[deflate]]]],[[deflate]],[[IETF]] [[原案標準]],"[[RFC 2616]], [[IANAREG]]"
,[CODE(HTTP)@en[[[x-deflate]],[[deflate]],→ [CODE(HTTP)@en[[[deflate]]]]
,[CODE(HTTP)@en[[[exi]]]],[[EXI]],[[W3C]] [[作業原案]],"[[EXI]], [[IANAREG]]"
,[CODE(HTTP)@en[[[gzip]]]],[[gzip]],[[IETF]] [[原案標準]],"[[RFC 2616]], [[IANAREG]]"
,[CODE(HTTP)@en[[[x-gzip]],[[gzip]],[[IETF]] [[情報提供RFC]] → [CODE(HTTP)@en[[[gzip]]]],[[RFC 1945]]
,[CODE(HTTP)@en[[[x-hqx]]]],[[BinHex]],
,[CODE(HTTP)@en[[[identity]]]],変形なし,[[IETF]] [[原案標準]],"[[RFC 2616]], [[IANAREG]]"
,[CODE(HTTP)@en[[[lzma]]]]
,[CODE(HTTP)@en[[[pack200-gzip]]]],,[[JSR]],"[[JSR#200]], [[IANAREG]]"
,[CODE(HTTP)@en[[[peerdist]]]]
,[CODE(HTTP)@en[[[quoted-printable]]]]
,[CODE(HTTP)@en[[[sdch]]]]
,[CODE(HTTP)@en[[[tar]]]]
,[CODE(HTTP)@en[[[text/html]]]],,非標準
,[CODE(HTTP)@en[[[text/plain]]]],,非標準
,[CODE(HTTP)@en[[[x_uuencode]]]]
,[CODE(HTTP)@en[[[x-zip]]]],[[compress]],→ [CODE(HTTP)@en[[[compress]]]]
,[CODE(HTTP)@en[[[xz]]]]
]FIG]

[5] 多分変てこなロボットだと思うんですが、
なぜか [CODE(HTTP)[Accept-Encoding]] に
[CODE(HTTP)[text/html]] とか [CODE(HTTP)[text/plain]]
とか送ってくる奴がいます。数でいうと結構出現頻度が高い。
(同じ奴ばっかだと思うけど。)

[7] [CODE(HTTP)[[[Accept-Encoding:]]]] 欄に 
[CODE(HTTP)[[[7bit]]]], [CODE(HTTP)[[[8bit]]]], 
[CODE(HTTP)[[[binary]]]] とか書く [[UA]] があるらしい。
なんか勘違いしているような気がする。

[8] [CODE(HTTP)[x-compress]], [CODE(HTTP)[x-gzip]] は、
[[HTTP/1.1]] が分かる相手には使うべきではありません。
逆に [CODE(HTTP)[compress]], [CODE(HTTP)[gzip]] は、 
[[HTTP/1.0]] しか分からない相手に使うべきではありません。

[6] 今時は HTTP/1.0 の実装でも [CODE(HTTP)[x-gzip]] は知ってるけど [CODE(HTTP)[gzip]] は知らないなんてのは無いみたいです。 [CODE(HTTP)[Accept-Encoding]] も [CODE(HTTP)[gzip]] で送ってくるのがほとんど。 ([CODE(HTTP)[x-gzip]] ''も''送ってくる奴も結構いますが。)

[22] [[SIP]] は [[HTTP]] と[[内容符号化]]の名前を共有しています [SRC[>>21]]。

[23] [[RFC 3261]] には「[CODE(HTTP)@en[[[tar]]]]」
という値の例がありますが [SRC[>>21]]、定義されていませんし、 [[IANA]]
にも登録されていません。

* IANA 登録簿

[436] [[内容符号化]]の値は、 [[IANA]] に登録する[RUBYB[べき]@en[ought to]]です [SRC[>>434]]。

[12] [[IANA登録簿]] (>>11) は、[[転送符号化]]とは別に設けられています。
しかし、同じ[[符号化]]の場合を除き、[[転送符号化]]と同じ名前を使っては[['''ならない''']]
[SRC[>>1]] とされています。

* 誤用

- [9] [CODE(HTTP)[Content-Encoding: gzip]] かつ [CODE(HTTP)[[[Content-Type:]] application/x-gzip]] で送ってくるサーバーがありますが、ほとんど間違いなく間違いなので(謎)、止めた方がいいですね。
-- [10] >>9 の問題の原因は実は [[Apache]] を [[distro]] 配布の [[RPM]] で入れたりした場合に、システム共用の [CODE(file)[[[/etc]]/[[mime.types]]]] が使われて、そのファイルに [CODE[application/x-gzip .gz]] って書いてある、って話だったりします。ちょっと困ったもんです。
- [16] [CODE(HTTP)[Content-Encoding: gzip]] かつ [CODE(HTTP)[[[Content-Type:]] application/x-gzip]] というレスポンスは、
[CODE[*.tar.gz]] などの形式で配布しているアーカイブのためなのでは無いのですか?
([[ten]] [WEAK[2004-06-02 11:43:03 +00:00]])

[17]
>>16 そのような応答は、
まず [CODE(HTTP)[Content-Encoding]] を復号して生に戻した状態で [CODE(MIME)[application/x-gzip]] として解釈するのが正解です。

[CODE(file)[[VAR[*]].tar.gz]] を更にもう一度 gzip 
で圧縮しているのであれば >>16 の通りで何ら問題ありませんが、
[CODE(file)[[VAR[*]].tar.gz]] をそのまま送っているのであれば問題です 
([CODE(MIME)[application/x-tar]] にでもなっていないと)。

([[名無しさん]] [WEAK[2004-06-03 00:24:16 +00:00]])

* セキュリティー

[45] [[BREACH]] 攻撃に注意が必要です。機密性の高い内容を扱う場合は攻撃できないように注意して設計するか、
[[圧縮]]を用いるべきではありません。

[47] 機密データと攻撃者が制御できるデータを (同じ圧縮辞書で)
一緒に[[圧縮]]しては[['''なりません''']]。データの出所が不明なら、
[[圧縮]]しては[['''なりません''']]。 [SRC[>>46]]

[48] 実用上は、元から[[圧縮]]されているデータの転送や[[静的ファイル]]の転送で[[内容符号化]]により[[圧縮]]することは問題ありませんが、
[[Webアプリケーション]]の出力など動的に変化する内容の転送には[[圧縮]]を用いるべきではないと考えられます。
動的な内容に適用する時は、それが (境界条件等例外的な場合も含めて) 
[[圧縮]]しても問題ないことを個別に確認する必要がありますし、
将来の改修によって問題ある状態に変化しないよう相当の注意を払い続ける必要があります。

* MIME との関係

[416] [CODE(HTTP)@en[[[Content-Encoding:]]]] [[ヘッダー]]は名前こそ 
[CODE[Content-]] がつきますが、
[[MIME]] では規定されておらず、 HTTP 独自のものです。

[2] 内容符号化は MIME の[[内容転送符号化]]や HTTP
の[[転送符号化]]よりも上 (データ側) の層に当たります。
MIME への[[関門]]では[[媒体型]]の指定に変換することが良いとされています。
(例: HTTP: [SAMP(HTTP)[Content-Encoding: gzip]]
→ MIME: [SAMP(HTTP)[Content-Type: [[application/x-gzip]]]])

[18] [[HTTP]] から [[MIME]] に変換するときには、
[CODE(HTTP)@en[[[Content-Type:]]]] [[ヘッダー]]の値を変更するか、
[[表現]]を[[復号]]してから[[転送]]するかの操作をする[RUBYB[べき]@en[ought to]]です
[SRC[>>15]]。

;; [19] [[RFC 1341]] 時代には [CODE(MIME)@en[[[application/octet-stream]]]]
に [CODE(MIME)@en[[[conversions]]]] [[引数]]があり、
これは [CODE(HTTP)@en[[[Content-Encoding:]]]] と同じ機能 [SRC[>>15]]
とされています。ただし [[MIME]] のこの機能は削除されています。

;; [20] [[MIME]] の [[CTE]] は[[内容符号化]]とは違う機能で、
[[内容符号化]]を [[CTE]] に置き換えることもできません。

* 透過内容折衝との関係

[26] [[透過内容折衝]]と[[内容符号化]]の[[内容折衝]]は直交するものです。
[[透過内容折衝]]の結果に[[内容符号化]]を適用できます。 [SRC[>>24]]

[28] [[鯖]]は、[[透過内容折衝]]の[[応答]]の[[内容符号化]]されていない版を提供できる[['''べきです''']] [SRC[>>24]]。

[30] [[Apache]] の実装では、[[内容符号化]]の折衝も[[透過内容折衝]]に含めています [SRC[>>27]]。

;; [CODE(HTTP)@en[[[encoding]]]] も参照。

[REFS[
- [27] [CITE[コンテントネゴシエーション - Apache HTTP サーバ]] 
<http://httpd.apache.org/docs/2.0/ja/content-negotiation.html#extensions>
]REFS]

* 歴史

[FIG(quote)[
[FIGCAPTION[
[429] RFC 2616 の3.5 Content Codings
]FIGCAPTION]

[PRE[
   Content coding values indicate an encoding transformation that has
   been or can be applied to an entity. Content codings are primarily
   used to allow a document to be compressed or otherwise usefully
   transformed without losing the identity of its underlying media type
   and without loss of information. Frequently, the entity is stored in
   coded form, transmitted directly, and only decoded by the recipient.
]PRE]

- content-coding   = token

[PRE[
   All content-coding values are case-insensitive. HTTP/1.1 uses
   content-coding values in the Accept-Encoding (section 14.3) and
   Content-Encoding (section 14.11) header fields. Although the value
   describes the content-coding, what is more important is that it
   indicates what decoding mechanism will be required to remove the
   encoding.
]PRE]

[PRE[
   The Internet Assigned Numbers Authority (IANA) acts as a registry for
   content-coding value tokens. Initially, the registry contains the
   following tokens:
]PRE]

[PRE[
   gzip An encoding format produced by the file compression program
        "gzip" (GNU zip) as described in RFC 1952 [25]. This format is a
        Lempel-Ziv coding (LZ77) with a 32 bit CRC.
]PRE]

ファイル圧縮プログラム「gzip」(GNU zip) で生成される符号化形式で、
RFC 1952 で説明されているもの。この形式は Lempel-Ziv 符号化 (LZ77)
と 32ビット [[CRC]] を使っています。

[PRE[
   compress
        The encoding format produced by the common UNIX file compression
        program "compress". This format is an adaptive Lempel-Ziv-Welch
        coding (LZW).
]PRE]

共通 UNIX ファイル圧縮プログラム「compress」で生成される符号化形式。
この形式は Lempel-Ziv-Welch 符号化 (LZW) の一応用です。

[PRE[
        Use of program names for the identification of encoding formats
        is not desirable and is discouraged for future encodings. Their
        use here is representative of historical practice, not good
        design. For compatibility with previous implementations of HTTP,
        applications SHOULD consider "x-gzip" and "x-compress" to be
        equivalent to "gzip" and "compress" respectively.
]PRE]

符号化形式にプログラム名を使うのは望ましいことではなく、
将来の符号化方式には推奨されません。ここで使っているのは
歴史的習慣表現であって、良い設計とはいえません。
HTTP の古い実装との互換性のため、応用は "x-gzip" と "x-compress"
をそれぞれ "gzip" および "compress" と同様に解釈するのが
'''望ましい'''です。

[PRE[
   deflate
        The "zlib" format defined in RFC 1950 [31] in combination with
        the "deflate" compression mechanism described in RFC 1951 [29].
]PRE]

RFC 1950 で定義された「zlib」形式と RFC 1951 で説明されている
「deflate」 (収縮) 形式を組み合わせたものです。

[PRE[
   identity
        The default (identity) encoding; the use of no transformation
        whatsoever. This content-coding is used only in the Accept-
        Encoding header, and SHOULD NOT be used in the Content-Encoding
        header.
]PRE]

規定 (同等) 符号化方式。無変形に使います。この内容符号化は
Accept-Encoding (承認符号化方式) 頭にのみ使われ、
Content-Encoding (内容符号化方式) 頭に使う'''べきではありません'''。

[PRE[
   New content-coding value tokens SHOULD be registered; to allow
   interoperability between clients and servers, specifications of the
   content coding algorithms needed to implement a new value SHOULD be
   publicly available and adequate for independent implementation, and
   conform to the purpose of content coding defined in this section.
]PRE]
]FIG]

[FIG(quote)[
[FIGCAPTION[
[430] HTTP/1.0 (RFC 1945) から抜粋
]FIGCAPTION]

[PRE[
       content-coding = "x-gzip" | "x-compress" | token
]PRE]

[PRE[
       Note: For future compatibility, HTTP/1.0 applications should
       consider "gzip" and "compress" to be equivalent to "x-gzip"
       and "x-compress", respectively.

** RFC 1945 (HTTP/1.0) 10.3; RFC 2068 14.12・2616 14.11 (HTTP/1.1) Content-Encoding
> The Content-Encoding entity-header field is used as a modifier to the
media-type. When present, its value indicates what additional content
codings have been applied to the entity-body, and thus what decoding
mechanism[INS[s [INS[{2068}]]]] [DEL[[INS[{1945}]] must]] [INS[[INS[{2068}]] MUST]] [INS[[INS[{2616}]] must]] be applied in order to obtain the media-type
referenced by the Content-Type header field. [DEL[[INS[{1945}]] The]] Content-Encoding is
primarily used to allow a document to be compressed without losing
the identity of its underlying media type.
]PRE]

[CODE(HTTP)[Content-Encoding]] 実体頭欄は、媒体型の修飾子として使います。
示されている時、その値は何の追加の内容符号化が [CODE(ABNF)[entity-body]]
に適用されており、ゆえに [CODE(HTTP)[[[Content-Type]]]]
頭欄で参照している媒体型を得るためには何の復号機構を適用しなければならないかを示します。
[CODE(HTTP)[Content-Encoding]] は主として元々の媒体型の識別を失うことなく文書を圧縮することを可能とするのに使います。

>
- Content-Encoding = "Content-Encoding" ":" [INS[[INS[{2068}]] 1#]]content-coding

> Content codings are defined in [DEL[[INS[{1945}]] Section]] [INS[[INS[{2068}]] section]] 3.5. An example of its use is
>
- Content-Encoding: [DEL[[INS[{1945}]] x-]]gzip

> The [DEL[[INS[{1945,2068}]] Content-Encoding]] [INS[[INS[{2616}]] [CODE(ABNF)[content-coding]]]] is a characteristic of the [DEL[[INS[{1945}]] resource]] [INS[[INS[{2068}]] entity]] identified by
the Request-URI. Typically, the [DEL[[INS[{1945}]] resource]] [INS[[INS[{2068}]] entity-body]] is stored with this
encoding and is only decoded before rendering or analogous usage. [INS[[INS[{2616}]] However, a non-transparent proxy MAY modify the content-coding if the new coding is known to be acceptable to the recipient, unless the "no-transform" cache-control directive is present in the message.]]

[CODE(ABNF)[content-coding]] は、 [CODE(ABNF)[[[Request-URI]]]]]
で識別される実体の特徴です。典型的には、 [CODE(ABNF)[[[entity-bnody]]]]
はこの符号化で蓄積され、レンダリングや同様の使用の前にだけ復号されます。 [INS[しかし、非透過串は、メッセージに [CODE(HTTP)[[[no-transform]]]] [CODE(ABNF)[cache-control]] 指令が示されていない限り、新しい符号化が受信者に受入れ可能であると分かっているなら、 [CODE(ABNF)[content-coding]] を修正しても'''構いません'''。]]

[INS[

> [INS[{2616}]]  If the content-coding of an entity is not "identity", then the
response MUST include a Content-Encoding entity-header (section
14.11) that lists the non-identity content-coding(s) used.

実体の [CODE(ABNF)[content-coding]] が [CODE(HTTP)[[[identity]]]]
でないなら、応答は使用した非 identity [CODE(ABNF)[content-coding]] を列挙した 
[CODE(HTTP)[Content-Encoding]] 実体頭欄を含めなければ'''なりません'''。

> If the content-coding of an entity in a request message is not
acceptable to the origin server, the server SHOULD respond with a
status code of 415 (Unsupported Media Type).

要求メッセージ中の実体の [CODE(ABNF)[content-coding]]
が起源サーバーに受け入れ可能でないときには、サーバーは状態符号
[CODE(HTTP)[[[415]]]] (未対応媒体型) で反応する'''べきです'''。
]INS]

[INS[

> [INS[{2068,2616}]] If multiple encodings have been applied to an entity, the content
codings MUST be listed in the order in which they were applied.
> Additional information about the encoding parameters MAY be provided
by other entity-header fields not defined by this specification.

複数の符号化が実体に適用されている時は、内容符号化はそれが適用された順に列挙しなければ'''なりません'''。
符号化引数についての追加情報をこの仕様書で定義していない他の実体頭欄で提供しても'''構いません'''。
]INS]
]FIG]

[FIG(quote)[
[FIGCAPTION[
[431] RFC 1945 (HTTP/1.0) C.3; RFC 2068 (HTTP/1.1) 19.4.3; RFC 2616 (HTTP/1.1) 19.4.4 Introduction of Content-Encoding
]FIGCAPTION]

> [DEL[[DEL[RFC 1521]] [INS[MIME]]]] [INS[RFC 2045]] does not include any concept equivalent to [DEL[HTTP/1.0]] [INS[HTTP/1.1]]'s 
Content-Encoding header field. Since this acts as a modifier on the media
type, proxies and gateways from HTTP to MIME-compliant protocols [DEL[must]] [INS[MUST]]
either change the value of the Content-Type header field or decode
the [DEL[Entity-Body]] [INS[entity-body]] before forwarding the message. (Some experimental
applications of Content-Type for Internet mail have used a media-type
parameter of ";conversions=<content-coding>" to perform [DEL[an equivalent function as]] [INS[[INS[{2616}]] a function equivalent to]] Content-Encoding. However, this parameter is not part of [DEL[[DEL[RFC 1521]] [INS[MIME]]]] [INS[RFC 2045]].)

[13] RFC 2045 は HTTP/1.1 の Content-Encoding
頭欄に相当する概念を持っていません。
この行為は媒体型を編集するものなので、 HTTP から MIME
に従ったプロトコルへの串と関門は Content-Type
頭欄の値を変えるか、[[実体本体]]をメッセージ転送の前に復号するかし'''なければなりません'''。
(Internet メイルの実験的 Content-Type 応用には媒体型パラメーター
";conversions=<content-coding>" を Content-Encoding
に相当する機能に使っているものもあります。
しかし、このパラメーターは RFC 2045 の一部ではありません。)

[INS[

[14] 訳注: [[application/octet-stream]]の [CODE[conversions]]
パラメーターのことかな?
]INS]

[INS[

注意: 注記のない修正点は RFC 1945 → RFC 2068 もの。
]INS]
]FIG]

[FIG(quote)[
[FIGCAPTION[
[432] RFC 1945 (HTTP/1.0); RFC 2068・2616 (HTTP/1.1) 3.5 Content Codings
]FIGCAPTION]

[421] 
> Content coding values [DEL[are used to]]
indicate an encoding transformation that has been [INS[or can be]]
applied to a[INS[n]] [DEL[resource]] [INS[entity]].
Content codings are primarily used to allow a document to be compressed or [DEL[encrypted]] [INS[otherwise usefully transformed]]
without losing the identity of its underlying media type [INS[and without loss of information]]. [DEL[Typically]] [INS[Frequently]], the [DEL[resource]] [INS[entity]] is stored in [DEL[this encoding]] [INS[coded form, transmitted directly,]] and only decoded [DEL[before rendering or analogous usage]] [INS[by the recipient]].

内容符号化値は、[[実体]]に適用されている、またはすることのできる符号化変形を示します。
内容符号化は、主として、もとの[[媒体型]]の識別を失うことなく、[INS[そして情報を失うことなく、]]文書を圧縮したり[DEL[暗号化したり]][INS[その他有用に変形したり]]するために使います。
多くの場面では、実体は符号化形で蓄積され、直接転送され、[DEL[レンダリングや同様の使用の前に]][INS[受信者によって]]のみ復号されます。

>
- content-coding = [DEL["x-gzip" | "x-compress" |]] token

[DEL[
> Note: For future compatibility, HTTP/1.0 applications should
consider "gzip" and "compress" to be equivalent to "x-gzip"
and "x-compress", respectively.

注意 : 将来との互換性のため、 HTTP/1.0 応用は
[CODE(HTTP)[gzip]] および [CODE(HTTP)[compress]] をそれぞれ
[CODE(HTTP)[x-gzip]] および [CODE(HTTP)[x-compress]]
と同等とみなすべきです。
]DEL]

> All content-coding values are case-insensitive. [DEL[HTTP/1.0]] [INS[HTTP/1.1]] uses
content-coding values in the [INS[Accept-Encoding (section 14.3) and]] Content-Encoding ([DEL[[INS[{1945}]] Section 10.3]] [INS[section [DEL[[INS[{2068}]] 14.12]] [INS[[INS[{2616}]] 14.11]]]]) header field[INS[s]].
Although the value describes the content-coding, what is more
important is that it indicates what decoding mechanism will be
required to remove the encoding. [DEL[Note that a single program may be capable of decoding multiple content-coding formats. Two values are defined by this specification:]]

すべての [CODE(ABNF)[content-coding]] 値は大文字・小文字を区別しません。
HTTP は内容符号化値を [INS[[CODE(HTTP)[[[Accept-Encoding]]]] 頭欄と]]
[CODE(HTTP)[[[Content-Encoding]]]] 頭欄で使います。
この値は [CODE(ABNF)[content-coding]] を記述しますが、
より重要なことは、この値が符号化を取り除くためにどの復号機構が必要であるかを示しているのだということです。[DEL[単一のプログラムに複数の [CODE(ABNF)[content-coding]] 書式を復号する能力があるかもしれないことに注意してください。この仕様書では2つの値を定義します:]]

[INS[
> The Internet Assigned Numbers Authority (IANA) acts as a registry for
content-coding value tokens. Initially, the registry contains the
following tokens:

[[IANA]] が [CODE(ABNF)[content-coding]] 値字句の登録簿として機能します。
はじめに、登録簿は次の字句を含みます :
]INS]

>
: [DEL[x-]]gzip :
An encoding format produced by the file compression program "gzip"
(GNU zip) [DEL[developed by Jean-loup Gailly]] [INS[as described in RFC 1952 [25] ]]. This format is [DEL[typically]] a Lempel-Ziv coding (LZ77) with a 32 bit CRC.
: [DEL[x-]]compress :
> The encoding format produced by the [INS[common UNIX]] file compression
program "compress". This format is an adaptive Lempel-Ziv-Welch
coding (LZW).

: [CODE(HTTP)[[DEL[x-]]gzip]] : [DEL[Jean‐loup Gailly が開発した]]ファイル圧縮プログラム [CODE[gzip]] (GNU zip)
が生成する符号化書式[INS[で、 [[RFC1952]] で説明されている]]。
この書式は[DEL[典型的には]] Lempel‐Ziv 符号化 ([[LZ77]])
に32ビット [[CRC]] を加えたものである。
: [CODE(HTTP)[[DEL[x-]]compress]] : [DEL[共通 UNIX]] ファイル圧縮プログラム
[CODE[compress]] が生成する符号化書式。この書式は Lempel‐Ziv‐Welch
符号化 ([[LZW]]) を使っている。

> [DEL[[INS[{1945,2068}]] Note:]] Use of program names for the identification of encoding
formats is not desirable and [DEL[[INS[{1945,2068}]] should be]] [INS[is]] discouraged for future
encodings. Their use here is representative of historical practice,
not good design. [INS[[INS[{2068,2616}]] For compatibility with previous implementations of HTTP, applications [DEL[should]] [INS[SHOULD]] consider "x-gzip" and "x-compress" to be equivalent to "gzip" and "compress" respectively.]]

符号化書式の識別にプログラム名を使うことは望ましくなく、
将来の符号化では非推奨[DEL[とするべき]]です。
ここでそうしているのは歴史的なものであって、良い設計ではありません。[INS[HTTP の以前の実装との互換性のために、[[応用]]は [CODE(HTTP)[x-gzip]] と [CODE(HTTP)[x-compress]] をそれぞれ [CODE(HTTP)[gzip]] と [CODE(HTTP)[compress]] に等しいものとみなす'''べきです'''。]]

[INS[
> [INS[{2068,2616}]]
: deflate : The "zlib" format defined in RFC 1950[31] in combination with
the "deflate" compression mechanism described in RFC 1951[29].

: [CODE(HTTP)[deflate]] : [[RFC1950]] で定義されている [CODE[zlib]]
書式と [[RFC1951]] で説明されている [CODE[deflate]] 圧縮機構の組合せ。

[INS[
>[INS[{2616}]]
: identity:
The default (identity) encoding; the use of no transformation
whatsoever. This content-coding is used only in the Accept-Encoding
header, and SHOULD NOT be used in the Content-Encoding header.

: [CODE(HTTP)[identity]] : 既定 (ママ) 符号化 — 特に何も変形していない。
この [CODE(ABNF)[content-coding]] は [CODE(HTTP)[[[Accept-Encoding]]]]
頭でのみ使用し、 [CODE(HTTP)[[[Content-Encoding]]]] 頭では使用する'''べきではない'''。
]INS]

> New content-coding value tokens [DEL[should]] [INS[SHOULD]] be registered; to allow
interoperability between clients and servers, specifications of the
content coding algorithms needed to implement a new value [DEL[should]] [INS[SHOULD]] be
publicly available and adequate for independent implementation, and
conform to the purpose of content coding defined in this section.

新しい [CODE(ABNF)[content-coding]] 値字句は登録する'''べきです'''。
[[クライアント]]と[[サーバー]]の間の相互運用性のために、
新しい値を実装するのに必要な内容符号化算法の仕様書が公開で利用可能であり、独立した実装に適当であり、この節で定義した内容符号化の目的に適合するものである'''べきです'''。
]INS]

[INS[
注 : 注記なき修正点は RFC 1945 → RFC 2068 における変更。
]INS]
]FIG]

[FIG(quote)[
[FIGCAPTION[
[433] RFC 2295 (HTTP 透過内容折衝) 10.8 Negotiation on content encoding
]FIGCAPTION]

[420] 
> Negotiation on the content encoding of a response is orthogonal to
transparent content negotiation.  The rules for when a content
encoding may be applied are the same as in HTTP/1.1: servers MAY
content-encode responses that are the result of transparent content
negotiation whenever an Accept-Encoding header in the request allows
it.  When negotiating on the content encoding of a cacheable
response, servers MUST add the accept-encoding header name to the
Vary header of the response, or add `Vary: *'.

応答の[[内容符号化]]に関する折衝は[[透過内容折衝]]とは直交します。
内容符号化を適用しても良い場合についての規則は HTTP/1.1
にあるのと同じで、サーバーは要求の [CODE(HTTP)[[[Accept-Encoding]]]]
頭が認めているときはいつでも透過内容折衝の結果の応答を内容符号化しても'''構いません'''。
[[キャッシュ可能]]応答の内容符号化の折衝の時には、
サーバーは [CODE(HTTP)[accept-encoding]] 頭名を応答の [CODE(HTTP)[[[Vary]]]]
頭に追加するか、 [CODE(HTTP)[Vary: *]] を追加するかしなければ'''なりません'''。

> Servers SHOULD always be able to provide unencoded versions of every
transparently negotiated response.  This means in particular that
every variant in the variant list SHOULD at least be available in an unencoded form.

サーバーは、各[[透過折衝可能応答]]の符号化されていない版を提供することが常に可能である'''べきです'''。
これは、特に[[変種目録]]にある各変種は少なくても符号化されていない形式で利用可能である'''べきである'''ことを意味します。

> Like HTTP/1.1, this specification allows proxies to encode or decode
relayed or cached responses on the fly, unless explicitly forbidden
by a Cache-Control directive.  The encoded or decoded response still
contains the same variant as far as transparent content negotiation
is concerned.  Note that HTTP/1.1 requires proxies to add a Warning
header if the encoding of a response is changed.

HTTP/1.1 同様に、この仕様書は、 [CODE(HTTP)[[[Cache-Control]]]]
指令が陽に禁じていない限り、中継あるいはキャッシュする応答を串が自動で符号化したり復号したりすることを認めます。
符号化あるいは復号した応答は、透過内容折衝に関する限りは依然として同じ変種を含んでいます。
HTTP/1.1 は串が応答の符号化を変更した時には [CODE(HTTP)[[[Warning]]]]
頭を追加することを要求しているのに注意してください。
]FIG]

[452] [CITE@en[RFC 4236 - HTTP Adaptation with Open Pluggable Edge Services (OPES)]]
( ([TIME[2014-09-22 20:05:44 +09:00]] 版))
<https://tools.ietf.org/html/rfc4236#section-3.2.7>

[451] [CITE[Remove the ability to control content codings. Fixes https://github.com/... · 43f8a7b · whatwg/fetch]]
( ([TIME[2014-08-01 07:01:59 +09:00]] 版))
<https://github.com/whatwg/fetch/commit/43f8a7b90f07325a58cc31c33129522443c8b843>

* 関連

[419] '''合わせて読みたい''': [[内容符号化と転送符号化]]、[[HTTP//変形]]

[418] [[内容符号化と転送符号化]]の項もあわせてご覧ください。

[422] [DFN[内容符号化]]は、 HTTP や派生プロトコルで[[実体]]に施されている符号化です。

[[MIME]] 的には[[媒体型]]に含まれてしまいますが、
媒体型を包含する別の媒体型とでも言うべき、独立したものであることが求められます。
[WEAK[例えば圧縮なら、「[[PNG]] で使っている圧縮」のような特定の媒体型に依存したものではなく、「gzip」のように圧縮対象に依存しないものでないといけません。]]

[[ホップ間]]の転送のための必要から行う変形は[[転送符号化]]というまた別のものになります。
HTTP の転送符号化は MIME の[[内容転送符号化]]にほぼ相当しますが、
これもやはり内容符号化とは別のものです。 (名前が似ているので注意。)

[REFS[
- [424] [CITE@en-us[SOAP over Java Message Service 1.0]]
( ([TIME[2012-02-15 02:00:44 +09:00]] 版))
<http://www.w3.org/TR/2012/REC-soapjms-20120216/#contentEncoding>
]REFS]

[425] [[合成型]]である [CODE(MIME)@en[[[multipart/*]]]] や [CODE(MIME)@en[[[message/*]]]] への適用について [[HTTP]]
仕様には明記されていません。

[426] [[SOAP/JMS]] では >>425 のケースで意味を未定義と明記しています [SRC[>>424]]。 
規定がないことには違いありません。

[44] [[実現値]]は、定義上、[[内容符号化]]の適用後を指しています。

* メモ

[453] [CITE@ja[Web サイトの読み込みエラー | Firefox ヘルプ]]
( ([TIME[2014-11-16 15:46:51 +09:00]] 版))
<https://support.mozilla.org/ja/kb/websites-dont-load-troubleshoot-and-fix-errors#w_kiagianeoeadaeaeiaau>

[52] [CITE@en[HTTP compression - Wikipedia, the free encyclopedia]]
([TIME[2015-07-27 23:42:37 +09:00]] 版)
<https://en.wikipedia.org/wiki/HTTP_compression>