376.txt

[43] [DFN[[CODE(HTTP)@en[[[Content-Length:]]]]]] [[ヘッダー]]は、
[[メッセージ本体]]の長さを表します。[[メッセージ本体]]が存在する [[HTTP/1]]
[[メッセージ][HTTPメッセージ]]で用いられます。

* 仕様書

[REFS[
- [38] [CITE@en[RFC 7230 - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing]] ([TIME[2014-06-07 01:59:35 +09:00]] 版) <https://tools.ietf.org/html/rfc7230#section-3.3>
-- [44] [CITE@en[RFC 7230 - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing]] ([TIME[2014-06-07 01:59:35 +09:00]] 版) <https://tools.ietf.org/html/rfc7230#section-3.3.2>
-- [312] [CITE@en[RFC 7230 - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing]] ([TIME[2014-06-07 01:59:35 +09:00]] 版) <https://tools.ietf.org/html/rfc7230#section-3.3.3>
- [314] [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-4.3.6>
- [206] [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-4.3.7>
- [56] [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-5.4>
- [62] [CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-15>
-- [60] [CITE@en[RFC 4918 - HTTP Extensions for Web Distributed Authoring and Versioning (WebDAV)]] ([TIME[2014-09-21 17:04:59 +09:00]] 版) <http://tools.ietf.org/html/rfc4918#section-15.4>
- [67] [CITE@en[RFC 6968 - FCAST: Object Delivery for the Asynchronous Layered Coding (ALC) and NACK-Oriented Reliable Multicast (NORM) Protocols]] ([TIME[2014-09-14 18:07:31 +09:00]] 版) <https://tools.ietf.org/html/rfc6968#page-10>
- [69] [CITE@en[RFC 6968 - FCAST: Object Delivery for the Asynchronous Layered Coding (ALC) and NACK-Oriented Reliable Multicast (NORM) Protocols]] ([TIME[2014-09-14 18:07:31 +09:00]] 版) <https://tools.ietf.org/html/rfc6968#section-3.3>
- [70] [CITE@en[RFC 6968 - FCAST: Object Delivery for the Asynchronous Layered Coding (ALC) and NACK-Oriented Reliable Multicast (NORM) Protocols]] ([TIME[2014-09-14 18:07:31 +09:00]] 版) <https://tools.ietf.org/html/rfc6968#page-21>
- [75] [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-8.1.2.6>
- [91] [CITE@en[Fetch Standard]] ([TIME[2017-07-19 19:00:41 +09:00]]) <https://fetch.spec.whatwg.org/#concept-http-network-or-cache-fetch>
]REFS]

* 意味

[45] [CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]は、
[CODE(HTTP)@en[[[Transfer-Encoding:]]]] [[ヘッダー]]のない[[メッセージ]]において
[[payload body]] のサイズを表すことができます [SRC[>>44]]。
これは [[payload body]] を含む[[メッセージ]]においては[[メッセージ]]の終端の位置を表す[[フレーム付け]]情報として必要なものであり、
[[payload body]] を含まない[[メッセージ]]においては選択された[[表現]]のサイズを示すものです
[SRC[>>44]]。

[39] [[要求メッセージ]]は通常[[メッセージ本体]]を持ちませんが、
[CODE(HTTP)@en[[[Content-Length:]]]] がある場合は[[メッセージ本体]]を持ちます [SRC[>>38]]。

;; [40] [[要求メソッド]]には依存しません。

* 構文

[46] 1桁以上の[[ASCII数字]]です [SRC[>>44]]。[[オクテット]]単位の[[十進数]]と解釈されます
[SRC[>>44]]。

;; [49] [[メッセージ本体]]が空の時は、 [CODE[0]] となります。

* 文脈

[90] たまに [CODE(HTTP)@en[Content-Length:]] [[ヘッダー]]は必須だと思っている人がいるようですが、
実際にはそうではありません。むしろ指定してはならない場面も少なくありません。
一方で、必要な場面や、実質的に指定しなければ困る場面もあって、複雑になっています。

-*-*-

[47] [[送信者]]は、 [CODE(HTTP)@en[[[Transfer-Encoding:]]]] [[ヘッダー]]がある[[メッセージ]]に
[CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]を含めては[['''なりません''']] [SRC[>>44]]。
両方がある時は、 [CODE(HTTP)@en[[[Transfer-Encoding:]]]]
が優先されます [SRC[>>38 3.3.3.]]。[[送信者]]は[[転送]]前に [CODE(HTTP)@en[[[Content-Length:]]]]
を削除しなければ[['''なりません''']] [SRC[>>38 3.3.3.]]。

[76] [[payload body]] を含む [[HTTP/2]] の[[要求]]や[[応答]]は、
[CODE(HTTP)@en[[[content-length]]]] [[ヘッダー]]を含むことができます [SRC[>>75]]。
その値は [[payload body]] を構成する [CODE[[[DATA]]]]
[[フレーム]]の [[payload]] 長の[[和]]と一致する必要があります。

[78] [[payload]] を持たないと定義されている [[HTTP/2]] [[応答]]は、
[CODE(HTTP)@en[[[content-length]]]] [[ヘッダー]]を含むことができます [SRC[>>75]]。
実際には [CODE[[[DATA]]]] [[フレーム]]に内容が含まれていなくて構いません。


-*-*-

[313] [[利用者エージェント]]は、[[メッセージ本体]]付きの[[要求]]を送る場合、
[[鯖]]が [[HTTP/1.1]] に対応していると分かっている場合を除き、
[CODE(HTTP)@en[[[Content-Length:]]]] を送らなければ[['''なりません''']] [SRC[>>312]]。

[48] [[利用者エージェント]]は、[[要求メソッド]]が [[payload body]]
の意味を定義している場合には、 [CODE(HTTP)@en[[[Transfer-Encoding:]]]]
か [CODE(HTTP)@en[[[Content-Length:]]]] を送る[['''べきです''']] [SRC[>>44]]。
[[要求メソッド]]が [[payload body]] の意味を定義しておらず、[[メッセージ]]が
[[payload body]] を含んでいない場合には、
[CODE(HTTP)@en[[[Content-Length:]]]] を送る[['''べきではありません''']]
[SRC[>>44]]。

[92] [[HTTP-network-or-cache fetch]] では、次のように決定されます [SRC[>>91]]。

[FIG(steps)[
= [93] [VAR[要求]]の[F[本体][要求本体]]が [CODE[null]] で、
[VAR[要求]]の[F[メソッド][要求メソッド]]が [CODE[POST]] か [CODE[PUT]] なら、
[N[0]] とします。
= [94] [VAR[要求]]の[F[本体][要求本体]]が [CODE[null]] ''以外''で、
[VAR[要求]]の[F[本体][要求本体]]の [F[source]] が [CODE[null]] ''以外''なら、
[[バイト数]]とします。
= [95] どちらでもない場合、設定しません。
]FIG]

;; [105] [[Webブラウザー]]は [[fetch]] による[[要求]]で
[CODE[Transfer-Encoding]] を使わないので、この[[手順群]]でもそれを検査していません。

-*-*-

[306] [[起源鯖]]は、 [CODE(HTTP)@en[[[Transfer-Encoding:]]]]
を使用しない場合、事前に [[payload size]] が分かっているなら、
以降に示す場合を除き、 [CODE(HTTP)@en[[[Content-Length:]]]]
[[ヘッダー]]を送信する[['''べきです''']] [SRC[>>44]]。

[214] [[鯖]]は、 [CODE(HTTP)@en[[[OPTIONS]]]] に対する[[応答]]に [[payload body]] を含まない場合、
[CODE(HTTP)@en[[[Content-Length]]: 0]] を[[生成]]しなければ[['''なりません''']] [SRC[>>206]]。

[50] [[鯖]]は、 [CODE(HTTP)@en[[[HEAD]]]] [[要求]]に対する[[応答]]に
[CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]を含めて構いませんが、
その場合 [CODE(HTTP)@en[[[GET]]]] だったなら返される[[応答]]で送られることになる
[[payload body]] のサイズを表すものでなければ[['''なりません''']] [SRC[>>44]]。

;; [53] [[キャッシュ]]における[[蓄積された応答]]の更新に使われます。
[SEE[ [CODE(HTTP)@en[HEAD]] ]]

[51] [[鯖]]は、[[条件付GET]]に対する [CODE(HTTP)[[[304]]]] [[応答]]に
[CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]を含めて構いませんが、
その場合 [CODE(HTTP)[[[200]]]] だったなら返される[[応答]]で送られることになる
[[payload body]] のサイズを表すものでなければ[['''なりません''']] [SRC[>>44]]。

[305] [[鯖]]は、 [CODE(HTTP)[[[1xx]]]] [[応答]]、[CODE(HTTP)[[[204]]]]
[[応答]]に [CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]を含めては[['''なりません''']]
[SRC[>>44]]。

[311] [[鯖]]は、 [CODE(HTTP)@en[[[CONNECT]]]] [[要求]]に対する [CODE(HTTP)[[[2xx]]]]
[[応答]]に [CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]を含めては[['''なりません''']]
[SRC[>>44, >>314]]。 [CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]があっても、
無視しなければなりません [SRC[>>38 3.3.3., >>314]]。


* 構文解析と処理

[307] [[受信者]]は、大きな数値が指定される場合もありますから、
[[桁溢れ]]による構文解析エラーを防がなければ[['''なりません''']] [SRC[>>44]]。

[82] [[Chrome]] と [[Firefox]] は[[ネットワークエラー]]とするようです。
[[IE]] はエラーにはしないようです (無視するかどうかは不明)。 [TIME[2015-07-30T08:42:20.800Z]]

[83] [[Chrome]] も [[Firefox]] も、 [CODE(HTTP)[[[304]]]] や
[CODE(HTTP)[[[1xx]]]] や
[CODE(HTTP)[[[HEAD]]]] への[[応答]]であっても、
不正な [CODE(HTTP)@en[[[Content-Length:]]]] を[[ネットワークエラー]]とするようです。
[TIME[2015-08-04T06:14:21.600Z]]

[308] [CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]が複数指定された場合や[[ヘッダー]]の値が[[リスト]]である場合で、
いずれも同じ十進数値の時は、この[[メッセージ]]を[[非妥当]]であるとして拒絶するか、
[CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]1つで数値1つに置き換えてから解釈したり、
[[転送]]したりするかのいずれかとしなければ[['''なりません''']] [SRC[>>44]]。

[309] [CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]が無視されない場合で、
複数指定されていて値が異なる場合や、値が[[非妥当]]な場合は、
[[接続]]を閉じなければ[['''なりません''']] [SRC[>>312]]。

[79] [[Chrome]] は次のように決定しているようです。 [TIME[2015-07-30T07:30:49.600Z]]
[FIG(steps)[
= [CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]すべての値を [CODE[,]] で連結します。
= [CODE[,]] (前後に任意個の[[空白]]) で分割してリストを得ます。
= リストに [[ASCII数字]]列のみで構成されるバイト列が1つも含まれていないなら、
無指定として扱います。
= それ以外なら、
== リストからバイト列としての重複を除去します。
== 複数項目のリストなら、[[ネットワークエラー]]とします。
== それ以外なら、唯一のリスト項目を[[十進整数]]として使います。
]FIG]

[80] [[Firefox]] は次のように決定しているようです。 [TIME[2015-07-30T07:38:02.00Z]]
[FIG(steps)[
= 複数あって、値が異なるなら、[[ネットワークエラー]]としてここで停止します。
= 値の先頭が [[ASCII数字]]列なら、[[十進整数]]を得ます。
= それ以外なら、無指定として扱います。
]FIG]

[81] [[IE]] は次のように決定しているようです。 [TIME[2015-07-30T07:41:00.700Z]]
[FIG(steps)[
= 複数あるなら、最初のものを使います。
= 値の先頭が [[ASCII数字]]列なら、[[十進整数]]を得ます。
= それ以外の値なら、 0 が指定されたとします。
]FIG]

[88] [[nginx]] は[[要求]]に複数の [CODE(HTTP)@en[Content-Length]] があるとき、
[CODE[400]] [[応答]]を返すようです。
[[Apache]] は [CODE(HTTP)@en[Content-Length]] を無視して[[接続][HTTP接続]]が閉じられるのを待つようです。
[TIME[2016-09-09T11:47:42.000Z]]

[89] [[要求]]の [CODE[Content-Length]] が不正な時、
[[nginx]] は [CODE[411]] を返し、 [[Apache]] は [CODE[400]]
を返すようです。 [TIME[2016-09-09T11:53:26.800Z]]

[310] [[メッセージ本体]]の長さの決定方法は、 [[メッセージ本体]]の項を参照してください。

[52] [[メッセージ本体]]が指定された長さに満たない場合については、
[[不完全メッセージ]]や [[HTTPS]] を参照してください。

[77] [[HTTP/2]] [[メッセージ]]の [CODE(HTTP)@en[[[Content-Length:]]]]
[[ヘッダー]]の値が [[payload body]] を構成する [CODE[[[DATA]]]]
[[フレーム]]の [[payload]] 長の[[和]]と等しくなければ、
[[奇形]]です。 [SRC[>>75]]
[SEE[ [[HTTPメッセージ]] ]]

[84] 実際には [[Chrome]] は[[奇形]]とはせずに無視するようです。
[[Firefox]] は値が[[非負整数]]から始まりそれが実際の長さと一致する場合を除き、
[[接続エラー]] [CODE[[[NO_ERROR]]]] とします。
[TIME[2015-10-11T09:38:34.00Z]]

[71] [[FCAST]] の実装は、 [CODE(HTTP)@en[[[Content-Length:]]]]
[[HTTPヘッダー]]に対応しなければ[['''なりません''']] [SRC[>>70]]。

* メタ変数 [CODE(CGI)@en[CONTENT_LENGTH]] (CGI)

[8] [[CGI]] の[[メタ変数]] [DFN[[CODE(CGI)@en[[[CONTENT_LENGTH]]]]]] の値は、
[[要求]]に付随する[RUBYB[[[メッセージ本体]]]@en[message-body]]のサイズです [SRC[>>20]]。

** 仕様書

[REFS[
- [20] [CITE@en[RFC 3875 - The Common Gateway Interface (CGI) Version 1.1]] ([TIME[2011-11-20 06:09:05 +09:00]] 版) <http://tools.ietf.org/html/rfc3875#section-4.1.2>
]REFS]

** 値

[4] [[要求]]に[[メッセージ本体]]が存在している場合、その場合に限り、[[鯖]]は [CODE(CGI)@en[[[CONTENT_LENGTH]]]]
[[メタ変数]]を設定しなければ[['''なりません''']] [SRC[>>20]]。

[21] 値は[[メッセージ本体]]のサイズを[[オクテット]]単位の[[十進数]]で表したものです [SRC[>>20]]。

[24] サイズは[[鯖]]が[[転送符号化]]や[[内容符号化]]を除去した後の[[メッセージ本体]]の長さでなければなりません
[SRC[>>20]]。

;; [25] [[転送符号化]]だけでなく[[内容符号化]]も必要に応じて除去しなければならないのですね。
[SEE[ [[要求データ]] ]]

[22] [[メッセージ本体]]が付属していない場合は値は [[NULL]] ([[空文字列]] or 未設定) です [SRC[>>20]]。

[FIG[
[23]
[PRE(ABNF code)[
      CONTENT_LENGTH = "" | 1*digit
]PRE]
[FIGCAPTION[
[SRC[>>20]]
]FIGCAPTION]
]FIG]

** メモ

[27] [[HTTP]] によりますと HTTP 通信においては [[Content-Length:欄]]
は必須ではありません。それが無くても長さが特定出来る場合は
省略出来るのです。ですが、上記のように CGI script
に渡される際には HTTP サーバーにより補われますので、
CGI script は安心して CONTENT_LENGTH の長さだけ標準入力を
読む、という処理が出来ます。

[28] HTTP の [CODE(HTTP)[[[Content-Length]]:]] 欄の値と実際の内容長が一致しない場合のサーバーの動作に注意が必要です。 [[HTTP/1.1]] だと多分問題になるのは与えられた内容長に達する前に接続がぶちぎられた場合ですか。そういう時適切な値に渡して CGI スクリプトに渡さないといけませんね。って普通そういう時は CGI スクリプトは実行しないかも。

[29] あるいは要求で [[chunked]] が使われてるけど [CODE(HTTP)[Content-Length:]] 欄の指定もあって、両者も矛盾している時かな。こういう時に HTTP サーバーが [CODE(CGI)[CONTENT_LENGTH]] をどうするべきかは規定がないと思いますが、実際の実体の長さをちゃんと返さないと駄目ですね。たぶんほとんどの CGI スクリプトは [CODE(CGI)[CONTENT_LENGTH]] を妄信しますから。。。

[30] ほとんど (全て?) の実装では、[[メタ変数]] [CODE(CGI)[HTTP_CONTENT_LENGTH]] は提供されません。この [CODE(CGI)[CONTENT_LENGTH]] で [WEAK[(実際にクライアントが指定した値を知りたいという奇特な場合を除いて)]] 不要ですから。

[31] 本体がないときには値 [CODE(CGI)[0]] ''ではなく'' [CODE(CGI)[NULL]] または空文字列になるのに注意が必要ですね。

[32] 注意しないといけないのは、 [[chunked]] 以外の[[転送符号化]]が使われているときです。 (>>29 が chunked の場合。 CGI には規定はないですが、 HTTP によれば [CODE(HTTP)[Content-Length]] が無視されます。) [CODE(HTTP)[Content-Length]] は転送符号化の結果の含めた長さですから、サーバーがスクリプトに転送符号化を解いた形でデータを渡す時には新しい値を設定しないといけません。 (サーバーがスクリプトに渡す前に転送符号化を解釈するべきかどうかは知らないんですが、ほとんどの CGI スクリプトの実装は転送符号化の存在がないと仮定してますよね。。。)

[33] >>32 今問題になってないのは、[[要求]]で転送符号化が使われることがまだそんなに (全然?) ないからに違いない。

;; [34] [[HTTP]] [[鯖]]は[[メッセージ本体]]を[[CGIスクリプト]]に引き渡す準備が出来る前に
[[CGIスクリプト]]を起動しても良いとされていますが、 [CODE(CGI)@en[[[CONTENT_LENGTH]]]]
を設定しなければならないという制約を考えると、起動前に[[メタ変数]]を確定させなければならない実装では、
本体の長さが確定するまで[[CGIスクリプト]]を起動できないことになります。
[[HTTP]] [CODE(HTTP)@en[[[Content-Length:]]]] [[欄]]が設定されていて[[転送符号化]]が使われていない場合であっても、
[[クライアント]]が途中で通信を切断する可能性があるので、最後まで読まないと値を確定できません。
(本当にそれでいいのでしょうか。実際の[[鯖]]の実装はそうなっていないように思います。)

* [CODE(822)@en[Content-Length:]] 欄 (電子メール)

[1] [WEAK[2002-11-15 (金) 18:10]] ''[[名無しさん]]'': [[HTTP]] ではなく[[電子メイル]]や[[電子ニュース]]でも使われるのがたまに見られます。古い [[MIME]] の draft に書いてあったのではないかと思いますが、確認していません。

** 関連

[2] [WEAK[2002-11-15 (金) 18:11]] ''[[名無しさん]]'': MIME 的には [[Content-Disposition]]:欄の "size" パラメーターが後に用意されました。

[3] [WEAK[2002-11-15 (金) 18:11]] ''2'': また電子ニュースでは伝統的に [[Lines]]:欄という似たものがあります。

* 異体説明 [CODE(HTTP)@en[length]] 異体属性

[57] [[異体説明]]の [DFN[[CODE(HTTP)@en[[[length]]]]]] [[異体属性]]は、
[CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]に相当するものです [SRC[>>56]]。

** 構文

[58] 属性値は、1つ以上の[[ASCII数字]]の列です [SRC[>>56]]。

[59] 属性値は[[異体]]の長さを反映しなければ[['''なりません''']]。
これには[[異体]]に埋め込まれたオブジェクトのサイズは含みません。 [SRC[>>56]]

* [CODE(URI)@en[DAV:getcontentlength]] 特性 (WebDAV)

[61] [DFN[[CODE(URI)@en[[[DAV:getcontentlength]]]]]] [[特性]]は、
[[accept header]] なしで [CODE(HTTP)@en[[[GET]]]] したら返されるであろう
[CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]を含むものです [SRC[>>60]]。

[64] [CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]で [[OWS]]
が含まれる場合でも、[[特性]]値には含める[['''べきではありません''']] [SRC[>>62]]。

[63] この[[特性]]は[[算出特性]]で、[[保護特性]]です [SRC[>>60]]。

[65] [[WebDAV]] に従う[[資源]]で [CODE(HTTP)@en[[[GET]]]] [[要求]]に対して
[CODE(HTTP)@en[[[Content-Length:]]]] [[ヘッダー]]を含む[[応答]]を返すものは、
この[[特性]]を定義しなければ[['''なりません''']] [SRC[>>60]]。

[66] [CODE(HTTP)@en[[[COPY]]]] や [CODE(HTTP)@en[[[MOVE]]]] の後は、
終点[[資源]]のサイズを表す値となります [SRC[>>60]]。

* [CODE(HTTP)@en[Content-Length:]] ヘッダー (FCAST)

[68] [[FCAST]] では [CODE(HTTP)@en[[[Content-Length:]]]] は[[内容符号化]]の適用前の[[オブジェクト]]の大きさを表します [SRC[>>67, >>69]]。

;; [[FCAST]] は [[HTTPヘッダー]]を使っていますが、[[メッセージ]]の構造は [[HTTP]]
と大きく異なっており、 [CODE(HTTP)@en[[[Content-Length:]]]] は[[フレーム付け]]には使いません。

[72] それ以外は [[HTTP]] と同じようです。

* 歴史

** HTTP92

[55] [[HTTP92]] では「This should be part of the MIME header」 [SRC[>>54]]
と言及されており、 [CODE(HTTP)@en[[[Content-Type:]]]] や
[CODE(HTTP)@en[[[Content-Transfer-Encoding:]]]] が [[MIME]]
の [[RFC]] を参照していることを見ても、 [[MIME]]
の改訂ないし拡張で純粋な [[HTTPヘッダー]]ではないと考えられていたと思われます。

[REFS[
- [54] [CITE[Object Header lines in HTTP]] ([TIME[2002-04-11 00:31:17 +09:00]] 版) <http://www.w3.org/Protocols/HTTP/Object_Headers.html#content-length>
]REFS]

** RFC

[FIG(quote)[
[FIGCAPTION[
[15] RFC 1945 (HTTP/1.0) 10.4; RFC 2068 14.14; RFC 2616 14.13 (HTTP/1.1) Content-Length
]FIGCAPTION]

> The Content-Length entity-header field indicates the size of 
the [DEL[[INS[{1945}]] Entity-Body]] [INS[[INS[{2068,2616}]] message-body]], in decimal number of octets, sent to the recipient or,
in the case of the HEAD method, the size of the [DEL[[INS[{1945}]] Entity-Body]] [INS[[INS[{2068,2616}]] entity-body]] that
would have been sent had the request been a GET.

[CODE(HTTP)[Content-Length]] 実体頭欄は、受信者に送られる [CODE(ABNF)[message-body]],
又は [CODE(HTTP)[[[HEAD]]]] method の場合には [CODE(HTTP)[[[GET]]]] 
での要求だったなら送られるであろう [CODE(ABNF)[entity-body]] の寸法をオクテット数の十進数表現で示します。

>
- Content-Length    = "Content-Length" ":" 1*DIGIT

> An example is
- Content-Length: 3495

> Applications [DEL[[INS[{1945}]] should]] [INS[[INS[{2068}]] SHOULD]] use this field to indicate the size of 
the [DEL[[INS[{1945}]] Entity-Body]] [INS[[INS[{2068,2616}]] message-body]]
to be transferred, regardless of the media type of the entity. [DEL[[INS[{1945}]] A valid Content-Length field value is required on all HTTP/1.0 request messages containing an entity body.]] [INS[[INS[{2068}]] It must be possible for the recipient to reliably determine the end of HTTP/1.1 requests containing an entity-body, e.g., because the request has a valid Content-Length field, uses Transfer-Encoding: chunked or a multipart body.]]

応用は、実体の媒体型に関わらず、転送する [CODE(ABNF)[message-body]]
の寸法を示すのにこの欄を用いる'''べきです'''。 [DEL[妥当な [CODE(HTTP)[Content-Length]] 欄値が、実体本体を含んでいる全ての HTTP/1.0 要求メッセージに必須です。]] [INS[受信者が [CODE(ABNF)[entity-body]] を含んだ HTTP/1.1 要求の終わりを確実に決定出来るように、例えば要求が妥当な [CODE(HTTP)[Content-Length]] 欄を持つとか、 [CODE(HTTP)[[[Transfer-Encoding]]: [[chunked]]]] を使うとか、[[複数部分実体]]であるとかでなければなりません。]]

> Any Content-Length greater than or equal to zero is a valid value.
Section [DEL[[INS[{1945}]] 7.2.2]] [INS[[INS[{2068}]] 4.4]] describes how to determine the length of a [DEL[[INS[{1945}]] response entity body]] [INS[[INS[{2068}]] message-body]]
if a Content-Length is not given.

零以上のどんな Content-Length も妥当な値です。4.4節は Content-Length
がない時に message-body の長さがどう決定されるかを説明しています。

> Note[DEL[: The [INS[{1945,2068}]]]] [INS[that the [INS[{2616}]]]] meaning of this field is significantly different from the
corresponding definition in MIME, where it is an optional field
used within the "message/external-body" content-type. In HTTP, 
it [DEL[[INS[{1945}]] should]] [INS[[INS[{2068}]] SHOULD]]
be used whenever the [DEL[[INS[{1945}]] entity]] [INS[[INS[{2068}]] message]]'s length can be determined prior[INS[, unless this is prohibited by the rules in section 4.4 [INS[{2616}]]]].
]FIG]

(要約: [[MIME]] の似たのとは違うのねん。)

[FIG(quote)[
[FIGCAPTION[
[16] RFC 2616 (HTTP/1.1) 4.4 Message Length
]FIGCAPTION]

[PRE[
   The transfer-length of a message is the length of the message-body as
   it appears in the message; that is, after any transfer-codings have
   been applied. When a message-body is included with a message, the
   transfer-length of that body is determined by one of the following
   (in order of precedence):
]PRE]

メッセージの transfer-length は message 中にある message-body の長さです。
これは、 transfer-codings が適用された後のものです。 message-body
がメッセージに含まれている場合、その本文の transfer-length
は次のもののいずれか一つ (優先順) で決定されます。

[PRE[
   1.Any response message which "MUST NOT" include a message-body (such
     as the 1xx, 204, and 304 responses and any response to a HEAD
     request) is always terminated by the first empty line after the
     header fields, regardless of the entity-header fields present in
     the message.
]PRE]

message-body を含んでは「'''いけない'''」応答メッセージ
(1xx, 204, 304 各応答と HEAD 要求の全ての応答) は常に頭欄の後の最初の
空行で終わります。メッセージに entity-header 欄があってもです。

[PRE[
   2.If a Transfer-Encoding header field (section 14.41) is present [DEL[and has any value other than "identity",]] then the transfer-length is
     defined by use of the "chunked" transfer-coding (section 3.6),
     unless the message is terminated by closing the connection.
]PRE]

[CODE(HTTP)[[[Transfer-Encoding]]]] 頭欄があ[DEL[って [CODE(HTTP)[[[identity]]]] 以外の値をと]]る場合、 [CODE(ABNF)[transfer-length]] は [CODE(HTTP)[[[chunked]]]]
[CODE(ABNF)[transfer-coding]] の使用により定義されます。
但しメッセージが接続を閉じることにより終わる場合を除きます。

[INS[

注 : 削除部分は errata (>>7) による。
]INS]

[PRE[
   3.If a Content-Length header field (section 14.13) is present, its
     decimal value in OCTETs represents both the entity-length and the
     transfer-length. The Content-Length header field MUST NOT be sent
     if these two lengths are different (i.e., if a Transfer-Encoding
     header field is present). If a message is received with both a
     Transfer-Encoding header field and a Content-Length header field,
     the latter MUST be ignored.
]PRE]

Content-Length 頭欄 ([[Content-Length:欄]]) がある場合、
OCTET での10進値が entity-length と transfer-length の両方を示します。
Content-Length 頭欄はこの2つの値が異なる (つまり Transfer-Encoding
頭欄がある) 時には送っては'''なりません'''。
Transfer-Encoding 頭欄と Content-Length 欄の両方を含むメッセージを
受け取った場合は、後者は無視しないと'''いけません'''。

> 4.If the message uses the media type "multipart/byteranges", and 
the [INS[t]]ransfer-length is not otherwise specified, then this 
self-[INS[d]]elimiting media type defines the transfer-length. 
This media type [INS[M]]UST NOT be used unless the sender knows that 
the recipient can [INS[p]]arse
it; the presence in a request of a Range header 
with  [INS[m]]ultiple byte-range specifiers from a 1.1 client implies that 
the [INS[c]]lient can parse multipart/byteranges responses.

メッセージが媒体型 "multipart/byteranges" を使用している場合、
かつ [INS[t]]ransfer-length が他で指定されていない時、この自己[INS[区]]切媒体型が
[CODE[transfer-length]] を定義します。
この媒体型は、受信者がこれを[INS[解]]析できると送信者が知っていない限り使っては'''[INS[い]]けません'''。
HTTP/1.1 クライアントからの[INS[複]]数の byte-range 指定がある Range 
頭がある要求は、[INS[ク]]ライアントが multipart/byteranges 
応答を解析できることを暗示しています。

[INS[

[7] 訳注: 原文欠落箇所は ''HTTP/1.1 Specification Errata''  [DEL[<http://world.std.com/~lawrence/http_errata.html#msg-len-chars>]] [INS[<http://purl.org/NET/http-errata#msg-len-chars]]
から補った。
]INS]

[PRE[
       A range header might be forwarded by a 1.0 proxy that does not
       understand multipart/byteranges; in this case the server MUST
       delimit the message using methods defined in items 1,3 or 5 of
       this section.
]PRE]

範囲頭は multipart/byteranges を理解しない HTTP/1.0 串が中継する
かもしれません。この場合、サーバーはメッセージをこの節の
1,3,5 項のいずれかで定義された方法を使って区切ら'''なければなりません'''。

[PRE[
   5.By the server closing the connection. (Closing the connection
     cannot be used to indicate the end of a request body, since that
     would leave no possibility for the server to send back a response.)
]PRE]

[PRE[
   For compatibility with HTTP/1.0 applications, HTTP/1.1 requests
   containing a message-body MUST include a valid Content-Length header
   field unless the server is known to be HTTP/1.1 compliant. If a
   request contains a message-body and a Content-Length is not given,
   the server SHOULD respond with 400 (bad request) if it cannot
   determine the length of the message, or with 411 (length required) if
   it wishes to insist on receiving a valid Content-Length.
]PRE]

[PRE[
   All HTTP/1.1 applications that receive entities MUST accept the
   "chunked" transfer-coding (section 3.6), thus allowing this mechanism
   to be used for messages when the message length cannot be determined
   in advance.
]PRE]

[PRE[
   Messages MUST NOT include both a Content-Length header field and a
   [DEL[non-identity]] transfer-coding. If the message does include a [DEL[non-identity]] transfer-coding, the Content-Length MUST be ignored.
]PRE]

[INS[

注 : 削除部分は errata (>>7) による。
]INS]

[PRE[
   When a Content-Length is given in a message where a message-body is
   allowed, its field value MUST exactly match the number of OCTETs in
   the message-body. HTTP/1.1 user agents MUST notify the user when an
   invalid length is received and detected.
]PRE]
]FIG]

[FIG(quote)[
[FIGCAPTION[
[17] RTSP (RFC 2326) 12.14 Content-Length
]FIGCAPTION]

> This field contains the length of the content of the method (i.e.
after the double CRLF following the last header). Unlike HTTP, it
MUST be included in all messages that carry content beyond the header
portion of the message. If it is missing, a default value of zero is
assumed. It is interpreted according to [H14.14].

[5] この欄は、[RUBY[方式] [method]] の内容
(つまり、最後の頭の後の 2つの CRLF の後) の長さから成ります。
HTTP とは違って、メッセージの頭部分を超えた内容を伝える全てのメッセージはこれを含め'''なければなりません'''。
これが欠けていた場合は既定値の零とみなします。
これは [H14.14] により解釈します。
]FIG]

** CGI

[FIG(quote)[
[FIGCAPTION[
[26] 6.1.2. CONTENT_LENGTH ([[CGI/1.1]] draft 03)
]FIGCAPTION]

>This metavariable is set to the size of the message-body
entity attached to the request, if any, in decimal number of
octets. If no data are attached, then this metavariable is
either NULL or not defined. The syntax is the same as for the
HTTP "Content-Length" header field (section 14.14, HTTP/1.1
specification [8]).

このメタ変数には、要求に添付されたメッセージ本体実体
があれば、その大きさを、10進のオクテット数で設定します。
データが添付されていない場合は、このメタ変数は NULL か未定義とします。
この構文は HTTP 「Content-Length」(内容長)頭領域
(HTTP/1.1 仕様書第14.14節) と同じです。   

CONTENT_LENGTH = "" | 1*digit

Servers MUST provide this metavariable to scripts if the
request was accompanied by a message-body entity.

サーバーは、要求にメッセージ本体実体がある場合、このメタ変数を
スクリプトに提供し'''なければなりません'''。
]FIG]

** [CODE(HTMLe)@en[object]] 要素 [CODE(HTMLa)@en[content-length]] 属性 (HTML)

[12] [[XHTML2]] の [CODE(HTMLe)@en[[[object]]]] [[要素]]には
[DFN[[CODE(HTMLa)@en[[[content-length]]]] [[属性]]]]が定義されていました。

[41] 参照されている[[オブジェクト]]の[[サイズ]]を表す[[ヒント]]とされていましたが、
どのように利用されるべきかは定義されていませんでした。

[13] 最初の[[作業原案]]では、[[属性]]の一覧には載っていましたが、肝心の定義が抜けていました。

[REFS[
- [18] [CITE@en[- XHTML Object Module]] ([TIME[2002-08-06 00:20:43 +09:00]] 版) <http://www.w3.org/TR/2002/WD-xhtml2-20020805/mod-object.html#s_objectmodule>
]REFS]

[14] 2つ目の[[作業原案]]で定義が追加されました。

[REFS[
- [19] [CITE@en[- XHTML Object Module]] ([TIME[2002-12-12 23:58:38 +09:00]] 版) <http://www.w3.org/TR/2002/WD-xhtml2-20021211/mod-object.html#adef_object_content-length>
]REFS]

[42] [[XHTML2]] 全体が支持を集められず、この[[属性]]も利用されることはありませんでした。

* 実装

[317] [[wget]] は、 [[CGIスクリプト]]に [CODE(HTTP)@en[[[Content-Length:]]]]
を正しく扱えないものがあるとして、 [CODE(HTTP)@en[[[Content-Length:]]]]
を無視する [CODE[[[--ignore-length]]]] オプションを用意しています。

* メモ

[FIG(amazon)[
HTTP
]FIG]

[9]
[CITE@en[RFC 3143 - Known HTTP Proxy/Caching Problems]] ([TIME[2008-08-30 12:43:01 +09:00]] 版) <http://tools.ietf.org/html/rfc3143#section-2.1.2>

- [6] [WEAK[2002-12-17 (火) 20:49]] ''[[名無しさん]]'': [[iモード]]に対して送るときは Content-Length: 欄は必須となります。 <http://www.nttdocomo.co.jp/mc-user/i/tag/s3.html>

[10]
[CITE[セキュリティホール memo - 2005.07]] <http://www.st.ryukoku.ac.jp/%7Ekjm/security/memo/2005/07.html#20050707_HRS>

[11] [CITE@en[RFC 3143 - Known HTTP Proxy/Caching Problems]] ([TIME[2008-08-30 12:43:01 +09:00]] 版) <http://tools.ietf.org/html/rfc3143#section-2.3.2>

[35] [CITE@en[RFC 4463 - A Media Resource Control Protocol (MRCP) Developed by Cisco, Nuance, and Speechworks]]
( ([TIME[2011-12-04 10:31:11 +09:00]] 版))
<http://tools.ietf.org/html/rfc4463#section-5.4.9>

[36] [CITE@en[draft-wood-dtnrg-http-dtn-delivery-07 - Using HTTP for delivery in Delay/Disruption-Tolerant Networks]]
( ([TIME[2012-02-26 11:11:35 +09:00]] 版))
<http://tools.ietf.org/html/draft-wood-dtnrg-http-dtn-delivery-07#page-6>

[37] [CITE@en[RFC 6787 - Media Resource Control Protocol Version 2 (MRCPv2)]]
( ([TIME[2012-11-13 15:18:40 +09:00]] 版))
<http://tools.ietf.org/html/rfc6787#section-6.2.11>

[315] [CITE[XMLHttpRequest/send-entity-body-get-head* tests should not fail if Content-Length is 0 · Issue #980 · w3c/web-platform-tests]]
( ([TIME[2014-07-14 05:19:37 +09:00]] 版))
<https://github.com/w3c/web-platform-tests/issues/980>

[316] [CITE[chromium chromium/src/net/http/http_network_transaction.cc]]
( ([TIME[2014-07-14 05:04:37 +09:00]] 版))
<http://mxr.mozilla.org/chromium/source/src/net/http/http_network_transaction.cc#866>

[318] [CITE@en[RFC 5547 - A Session Description Protocol (SDP) Offer/Answer Mechanism to Enable File Transfer]]
( ([TIME[2014-09-13 18:22:39 +09:00]] 版))
<https://tools.ietf.org/html/rfc5547#page-30>

[319] [CITE[RFC Errata Report]]
( ([TIME[2014-11-03 06:56:27 +09:00]] 版))
<http://www.rfc-editor.org/errata_search.php?rfc=5547>

[FIG(quote)[
[FIGCAPTION[
[73] [CITE@en[Necko/Differences - MozillaWiki]]
([TIME[2015-03-21 17:34:27 +09:00]] 版)
<https://wiki.mozilla.org/Necko/Differences>
]FIGCAPTION]

> We reject responses with negative Content-Length; Chrome accepts them and ignores the Content-Length (apparently).

]FIG]


[74] [CITE@en[Define setting Content-Length and its quirks · whatwg/fetch@c103d09]]
([TIME[2015-05-06 16:36:38 +09:00]] 版)
<https://github.com/whatwg/fetch/commit/c103d0962dc4cb9e76c5425213fa8459509fa3d5>

[85] [CITE@en[No longer include Content-Length for HEAD requests]]
([[annevk]]著, [TIME[2016-07-18 23:47:21 +09:00]])
<https://github.com/whatwg/fetch/commit/674b4d3f9606b22993bc61e135f2739b668c85a1>

[86] [CITE@en[Issue 455939 - chromium - Stop sending Content-Length:0 header in all HEAD requests. - Monorail]]
([TIME[2016-07-19 11:23:09 +09:00]])
<https://bugs.chromium.org/p/chromium/issues/detail?id=455939>

[87] [CITE@en[Preventing some CRLF header injection attacks · Issue #375 · whatwg/fetch]]
([TIME[2016-08-25 12:05:47 +09:00]])
<https://github.com/whatwg/fetch/issues/375>

[96] [CODE[video]] [[要素]]で [[MP4]] [[動画]]を[[再生]]させるとき、
[[動画]]の全体時間が表示されるかどうかについて、
[[Firefox]] では [CODE[Content-Length:]] の値が使われているようです。
指定されない場合には ([[本体]]全体を読み終わった後であっても) 全時間は表示されませんし、
現在時刻以後にシークもできません。
[TIME[2017-08-27T07:56:11.200Z]]

[97] [CITE@en[Multiple Content-Length values that mismatch · Issue #59 · httpwg/http-core]]
([TIME[2018-04-22 19:39:22 +09:00]])
<https://github.com/httpwg/http-core/issues/59>

[98] [CITE@en[Parsing Content-Length by annevk · Pull Request #10548 · w3c/web-platform-tests]]
([TIME[2018-04-22 19:40:23 +09:00]])
<https://github.com/w3c/web-platform-tests/pull/10548>

[99] [CITE@en[CORS: safelist Content-Length header]]
([[benjamingr]]著, [TIME[2018-05-10 00:15:51 +09:00]])
<https://github.com/whatwg/fetch/commit/3a896efe58c45ba2073c2f8370a1b5e41c4f49aa>

[100] [CITE@en[Expose Content-Length header in CORS requests · Issue #622 · whatwg/fetch]]
([TIME[2018-05-10 12:40:20 +09:00]])
<https://github.com/whatwg/fetch/issues/622>

[101] [CITE@en[Safelist Content-Length header by benjamingr · Pull Request #626 · whatwg/fetch]]
([TIME[2018-05-10 12:41:46 +09:00]])
<https://github.com/whatwg/fetch/pull/626>

[102] [CITE@en[Allow Range header to be set by APIs]]
([[jakearchibald]]著, [TIME[2018-05-30 02:00:06 +09:00]])
<https://github.com/whatwg/fetch/commit/819d8c9d6617986a831ecd9cf21c34ba9589a890>

[FIG(quote)[
[FIGCAPTION[
[103] [CITE[curl - How To Use]]
([TIME[2020-09-21T09:01:13.000Z]], [TIME[2020-10-01T06:16:10.379Z]])
<https://curl.haxx.se/docs/manpage.html#--ignore-content-length>
]FIGCAPTION]

> For HTTP, Ignore the Content-Length header. This is particularly useful for servers running Apache 1.x, which will report incorrect Content-Length for files larger than 2 gigabytes.

]FIG]


[104] [CITE@en[GNU Wget 1.20 Manual]]
([TIME[2020-10-01T07:22:21.000Z]])
<https://www.gnu.org/software/wget/manual/wget.html#index-ignore-length>


[106] [[ダウンロード]]の予想時間の見積もりってどうしたらいいんでしょうかね?
[CODE[Content-Length]] 使えば良さそうと思ったんですけど、
[CODE[chunked]] が使われていると [CODE[Content-Length]]
は信用できないし[[中間器]]に削除されちゃうことがあるのでしょう。
でも [CODE[chunked]] の長さは全体の長さとは限らない (そうでないことのほうが多い?) し。