5. ヘッダーフィールドの定義
本セクションは、キャッシュに関連する HTTP/1.1 ヘッダーフィールドの構文とセマンティクスを定義します。
5.1. Age
"Age" ヘッダーフィールドは、応答がオリジンサーバーで生成または正常に検証されてからの時間についての送信者の推定を伝えます。Age の値はセクション 4.2.3 に従って計算されます。
Age = delta-seconds
Age フィールドの値は、秒単位の時間を表す非負の整数です (セクション 1.2.1 参照)。
Age ヘッダーフィールドが存在することは、その応答がこのリクエストに対してオリジンサーバーによって生成または検証されたものではないことを意味します。ただし、Age ヘッダーフィールドがないからといって、オリジンに問い合わせたとは限りません。Age を実装していない HTTP/1.0 キャッシュから応答を受信した可能性があるためです。
5.2. Cache-Control
"Cache-Control" ヘッダーフィールドは、リクエスト/応答チェーン上のキャッシュに対するディレクティブを指定するために使用されます。このようなキャッシュディレクティブは単方向であり、リクエストにディレクティブが存在しても、同じディレクティブが応答で与えられるべきことを意味しません。
キャッシュは、本セクションで定義された Cache-Control ディレクティブの要件に従わなければならない (MUST)。他の場所で定義された Cache-Control ディレクティブの扱いについては、セクション 5.2.3 を参照してください。
注: 一部の HTTP/1.0 キャッシュは Cache-Control を実装していない可能性があります。
プロキシは、キャッシュを実装しているかどうかにかかわらず、転送するメッセージ内でキャッシュディレクティブをそのまま通過させなければならない (MUST)。そのディレクティブがそのアプリケーションにとって重要かどうかは関係ありません。ディレクティブはリクエスト/応答チェーン上のすべての受信者に適用される可能性があるためです。ディレクティブを特定のキャッシュだけを対象にすることはできません。
キャッシュディレクティブはトークンによって識別され、大文字と小文字を区別せずに比較され、省略可能な引数を持ち、その引数はトークン構文と quoted-string 構文の両方を使用できます。以下で定義する、引数を定義するディレクティブについては、受信者は両方の形式を受け入れるべきです。一方が好ましいと記述されていてもかまいません。本仕様で定義されていないディレクティブについては、受信者は両方の形式を受け入れなければならない (MUST)。
Cache-Control = 1#cache-directive
cache-directive = token [ "=" ( token / quoted-string ) ]
以下で定義するキャッシュディレクティブについては、別途明記されていない限り、引数は定義されておらず (許可もされていません)。
5.2.1. リクエスト Cache-Control ディレクティブ
5.2.1.1. max-age
引数の構文: delta-seconds (セクション 1.2.1 参照)
"max-age" リクエストディレクティブは、クライアントが、指定された秒数より大きい年齢の応答を受け入れることを望まないことを示します。max-stale リクエストディレクティブも存在しない限り、クライアントは古い応答を受け入れることを望みません。
このディレクティブは引数構文のトークン形式を使用します。例えば 'max-age=5' であり、'max-age="5"' ではありません。送信者は quoted-string 形式を生成すべきではありません (SHOULD NOT)。
5.2.1.2. max-stale
引数の構文: delta-seconds (セクション 1.2.1 参照)
"max-stale" リクエストディレクティブは、クライアントが新鮮度ライフタイムを超過した応答を受け入れることを望むことを示します。max-stale に値が割り当てられている場合、クライアントは新鮮度ライフタイムを指定された秒数以内だけ超過した応答を受け入れることを望みます。max-stale に値が割り当てられていない場合、クライアントは任意の年齢の古い応答を受け入れることを望みます。
このディレクティブは引数構文のトークン形式を使用します。例えば 'max-stale=10' であり、'max-stale="10"' ではありません。送信者は quoted-string 形式を生成すべきではありません (SHOULD NOT)。
5.2.1.3. min-fresh
引数の構文: delta-seconds (セクション 1.2.1 参照)
"min-fresh" リクエストディレクティブは、クライアントが、新鮮度ライフタイムがその現在の年齢に指定された秒数を加えた値以上の応答を受け入れることを望むことを示します。つまり、クライアントは、少なくとも指定された秒数の間はまだフレッシュであり続ける応答を望んでいます。
このディレクティブは引数構文のトークン形式を使用します。例えば 'min-fresh=20' であり、'min-fresh="20"' ではありません。送信者は quoted-string 形式を生成すべきではありません (SHOULD NOT)。
5.2.1.4. no-cache
"no-cache" リクエストディレクティブは、キャッシュが、オリジンサーバーでの検証に成功することなく、格納された応答をリクエストの充足に使用してはならない (MUST NOT) ことを示します。
5.2.1.5. no-store
"no-store" リクエストディレクティブは、キャッシュが、このリクエストおよびそれへの応答のいずれの一部も格納してはならない (MUST NOT) ことを示します。このディレクティブは、プライベートキャッシュと共有キャッシュの両方に適用されます。この文脈における「MUST NOT 格納する」とは、キャッシュがその情報を意図的に不揮発性ストレージに格納してはならず (MUST NOT)、転送した後はできるだけ速やかにその情報を揮発性ストレージから削除するよう最善を尽くさなければならない (MUST) ことを意味します。
このディレクティブは、プライバシーを確保するための信頼できる、あるいは十分な仕組みではありません。特に、悪意のある、あるいは侵害されたキャッシュは、このディレクティブを認識しないか従わない可能性があり、通信ネットワークは盗聴に対して脆弱である可能性があります。
このディレクティブを含むリクエストがキャッシュから満たされる場合、no-store リクエストディレクティブは、すでに格納されている応答には適用されないことに注意してください。
5.2.1.6. no-transform
"no-transform" リクエストディレクティブは、中間要素 (キャッシュを実装しているかどうかにかかわらず) が、[RFC7230] のセクション 5.7.2 で定義されているペイロードを変換してはならない (MUST NOT) ことを示します。
5.2.1.7. only-if-cached
"only-if-cached" リクエストディレクティブは、クライアントが格納された応答の取得のみを望んでいることを示します。このディレクティブを受信した場合、キャッシュは、リクエストの他の制約と整合する格納された応答を使用して応答するか (SHOULD)、504 (Gateway Timeout) ステータスコードで応答すべきです。キャッシュのグループが内部接続性の良好な統合システムとして運用されている場合、そのグループ内のメンバーキャッシュは、そのキャッシュグループ内でそのようなリクエストを転送してもよい (MAY)。
5.2.2. 応答 Cache-Control ディレクティブ
5.2.2.1. must-revalidate
"must-revalidate" 応答ディレクティブは、一度古くなったならば、キャッシュが、オリジンサーバーでの検証に成功することなく、その応答を後続のリクエストの充足に使用してはならない (MUST NOT) ことを示します。
must-revalidate ディレクティブは、特定のプロトコル機能の信頼できる動作を支えるために必要です。あらゆる状況において、キャッシュは must-revalidate ディレクティブに従わなければならない (MUST)。特に、キャッシュが何らかの理由でオリジンサーバーに到達できない場合、504 (Gateway Timeout) 応答を生成しなければならない (MUST)。
must-revalidate ディレクティブは、その表現に対するリクエストの検証に失敗すると、静かに実行されない金融取引のように、誤った動作を招く可能性がある場合に限り、サーバーによって使用されるべきです。
5.2.2.2. no-cache
引数の構文: #field-name
"no-cache" 応答ディレクティブは、その応答が、オリジンサーバーでの検証に成功することなく後続のリクエストの充足に使用されてはならない (MUST NOT) ことを示します。これにより、オリジンサーバーは、たとえ古い応答を送信するよう構成されたキャッシュであっても、オリジンサーバーに問い合わせることなくその応答を使ってリクエストを満たすことをキャッシュに防がせることができます。
no-cache 応答ディレクティブが 1 つ以上の field-name を指定する場合、キャッシュは、キャッシュに関する他の制限に従うことを条件に、その応答を後続のリクエストの充足に使用してもよい (MAY)。ただし、応答内でその field-name を持つヘッダーフィールドは、オリジンサーバーとの再検証に成功することなく、後続のリクエストへの応答で送信されてはならない (MUST NOT)。これにより、オリジンサーバーは、応答の残りのキャッシュを依然として許可しつつ、応答内の特定のヘッダーフィールドの再利用を防ぐことができます。
与えられる field-name は、本仕様で定義されたヘッダーフィールドの集合に限定されません。フィールド名は大文字と小文字を区別しません。
このディレクティブは引数構文の quoted-string 形式を使用します。送信者はトークン形式を生成すべきではありません (SHOULD NOT) (単一エントリのリストでは引用符が必要ないように見えても)。
注: このディレクティブは多くの実装にバックポートされていますが、一部の HTTP/1.0 キャッシュはこれを認識しないか従いません。また、field-name 付きの no-cache 応答ディレクティブは、キャッシュによって、限定なしの no-cache ディレクティブを受信したかのように扱われることがよくあります。すなわち、限定形式に対する特別な処理は広く実装されていません。
5.2.2.3. no-store
"no-store" 応答ディレクティブは、キャッシュが、直接のリクエストまたは応答のいずれの一部も格納してはならない (MUST NOT) ことを示します。このディレクティブは、プライベートキャッシュと共有キャッシュの両方に適用されます。この文脈における「MUST NOT 格納する」とは、キャッシュがその情報を意図的に不揮発性ストレージに格納してはならず (MUST NOT)、転送した後はできるだけ速やかにその情報を揮発性ストレージから削除するよう最善を尽くさなければならない (MUST) ことを意味します。
このディレクティブは、プライバシーを確保するための信頼できる、あるいは十分な仕組みではありません。特に、悪意のある、あるいは侵害されたキャッシュは、このディレクティブを認識しないか従わない可能性があり、通信ネットワークは盗聴に対して脆弱である可能性があります。
5.2.2.4. no-transform
"no-transform" 応答ディレクティブは、中間要素 (キャッシュを実装しているかどうかにかかわらず) が、[RFC7230] のセクション 5.7.2 で定義されているペイロードを変換してはならない (MUST NOT) ことを示します。
5.2.2.5. public
"public" 応答ディレクティブは、たとえその応答が通常はキャッシュ不可能であるか、プライベートキャッシュ内でのみキャッシュ可能である場合でも、あらゆるキャッシュがその応答を格納してもよい (MAY) ことを示します。(Authorization を含むリクエストへの応答で public を使用することに関する詳細はセクション 3.2 を、ステータスコードが既定でキャッシュ可能と定義されていないために通常は格納されない応答に public がどのように影響するかの詳細はセクション 3 を参照してください。セクション 4.2.2 も参照してください。)
5.2.2.6. private
引数の構文: #field-name
"private" 応答ディレクティブは、その応答メッセージが単一のユーザーを対象としており、共有キャッシュがそれを格納してはならない (MUST NOT) ことを示します。プライベートキャッシュは、その応答を格納し、たとえそれが通常はキャッシュ不可能であっても、後のリクエストのために再利用してもよい (MAY)。
private 応答ディレクティブが 1 つ以上の field-name を指定する場合、この要件は、列挙された応答ヘッダーフィールドに関連付けられたフィールド値に限定されます。すなわち、共有キャッシュは、指定された field-name(s) を格納してはならず (MUST NOT)、応答メッセージの残りの部分は格納してもよい (MAY)。
与えられる field-name は、本仕様で定義されたヘッダーフィールドの集合に限定されません。フィールド名は大文字と小文字を区別しません。
このディレクティブは引数構文の quoted-string 形式を使用します。送信者はトークン形式を生成すべきではありません (SHOULD NOT) (単一エントリのリストでは引用符が必要ないように見えても)。
注: ここでの "private" という語の用法は、応答をどこに格納できるかを制御するだけであり、メッセージ内容のプライバシーを保証することはできません。また、field-name 付きの private 応答ディレクティブは、キャッシュによって、限定なしの private ディレクティブを受信したかのように扱われることがよくあります。すなわち、限定形式に対する特別な処理は広く実装されていません。
5.2.2.7. proxy-revalidate
"proxy-revalidate" 応答ディレクティブは、private キャッシュには適用されないことを除き、must-revalidate 応答ディレクティブと同じ意味を持ちます。
5.2.2.8. max-age
引数の構文: delta-seconds (セクション 1.2.1 参照)
"max-age" 応答ディレクティブは、その応答が、その年齢が指定された秒数より大きくなった後に古いものと見なされることを示します。
このディレクティブは引数構文のトークン形式を使用します。例えば 'max-age=5' であり、'max-age="5"' ではありません。送信者は quoted-string 形式を生成すべきではありません (SHOULD NOT)。
5.2.2.9. s-maxage
引数の構文: delta-seconds (セクション 1.2.1 参照)
"s-maxage" 応答ディレクティブは、共有キャッシュにおいて、このディレクティブで指定された最大年齢が、max-age ディレクティブまたは Expires ヘッダーフィールドで指定された最大年齢を上書きすることを示します。s-maxage ディレクティブは、proxy-revalidate 応答ディレクティブのセマンティクスも暗黙的に含みます。
このディレクティブは引数構文のトークン形式を使用します。例えば 's-maxage=10' であり、's-maxage="10"' ではありません。送信者は quoted-string 形式を生成すべきではありません (SHOULD NOT)。
5.2.3. キャッシュ制御拡張
Cache-Control ヘッダーフィールドは、それぞれが省略可能な値を持つ 1 つ以上の cache-extension トークンを使用して拡張できます。キャッシュは、認識できないキャッシュディレクティブを無視しなければならない (MUST)。
情報提供的な拡張 (キャッシュの動作の変更を必要としないもの) は、他のディレクティブのセマンティクスを変更することなく追加できます。
動作拡張は、既存のキャッシュディレクティブの基盤に対する修飾子として機能するように設計されています。新しいディレクティブと古いディレクティブの両方が与えられるため、新しいディレクティブを理解しないアプリケーションは古いディレクティブが指定する動作を既定とし、新しいディレクティブを理解するアプリケーションはそれを、古いディレクティブに関連する要件を変更するものとして認識します。このようにして、展開済みのキャッシュを壊すことなく、既存のキャッシュ制御ディレクティブを拡張できます。
例えば、private ディレクティブへの修飾子として機能する、"community" と呼ばれる仮想的な新しい応答ディレクティブを考えてみます。すなわち、プライベートキャッシュに加えて、指定された community のメンバーのみが共有するキャッシュも、その応答をキャッシュすることが許可されます。UCI コミュニティが、本来プライベートな応答を自身の共有キャッシュで使用できるようにしたいオリジンサーバーは、次のように含めることでそれができます:
Cache-Control: private, community="UCI"
そのような community キャッシュ拡張を認識するキャッシュは、その拡張に従って動作を広げることができます。community キャッシュ拡張を認識しないキャッシュは、それを無視して private ディレクティブに従います。
5.3. Expires
"Expires" ヘッダーフィールドは、その日時を過ぎると応答が古いものと見なされる日時を与えます。新鮮度モデルの詳細な説明については、セクション 4.2 を参照してください。
Expires フィールドの存在は、元のリソースがその時点、その前、またはその後に変化する、あるいは存在しなくなることを意味しません。
Expires の値は、[RFC7231] のセクション 7.1.1.1 で定義されている HTTP-date タイムスタンプです。
Expires = HTTP-date
例えば
Expires: Thu, 01 Dec 1994 16:00:00 GMT
キャッシュの受信者は、無効な日付形式、特に値 "0" を、過去の時刻 (すなわち「すでに期限切れ」) を表すものとして解釈しなければならない (MUST)。
応答が max-age ディレクティブ (セクション 5.2.2.8) を持つ Cache-Control フィールドを含む場合、受信者は Expires フィールドを無視しなければならない (MUST)。同様に、応答が s-maxage ディレクティブ (セクション 5.2.2.9) を含む場合、共有キャッシュの受信者は Expires フィールドを無視しなければならない (MUST)。これらのいずれの場合も、Expires の値は、Cache-Control フィールドをまだ実装していない受信者だけを対象としています。
時計を持たないオリジンサーバーは、その値が固定の過去の時刻 (常に期限切れ) を表すか、その値が信頼できる時計を持つシステムまたはユーザーによってリソースに関連付けられているのでない限り、Expires フィールドを生成してはならない (MUST NOT)。
歴史的に、HTTP は Expires フィールド値が未来の 1 年以内であることを要求していました。より長い新鮮度ライフタイムはもはや禁止されていませんが、極端に大きな値は問題を引き起こすことが実証されており (例えば、時刻値に 32 ビット整数を使用することによる時計のオーバーフロー)、多くのキャッシュはそれよりずっと早く応答を破棄します。
5.4. Pragma
"Pragma" ヘッダーフィールドは、HTTP/1.0 キャッシュとの後方互換性を可能にし、クライアントが自身の理解する "no-cache" リクエストを指定できるようにします (Cache-Control は HTTP/1.1 まで定義されなかったため)。リクエスト内で Cache-Control ヘッダーフィールドも存在し理解される場合、Pragma は無視されます。
HTTP/1.0 では、Pragma は、受信者向けの実装指定のディレクティブのための拡張可能なフィールドとして定義されていました。本仕様は、相互運用性を向上させるためにそのような拡張を非推奨とします。
Pragma = 1#pragma-directive
pragma-directive = "no-cache" / extension-pragma
extension-pragma = token [ "=" ( token / quoted-string ) ]
リクエストに Cache-Control ヘッダーフィールドが存在しない場合、キャッシュは、no-cache リクエスト pragma-directive を、"Cache-Control: no-cache" が存在する場合と同じ効果を持つものと見なさなければならない (MUST) (セクション 5.2.1 参照)。
no-cache リクエストを送信するとき、クライアントは pragma と cache-control の両方のディレクティブを含めるべきです。ただし、他の Cache-Control 応答ディレクティブを HTTP/1.1 キャッシュに狙いを定めるために、Cache-Control: no-cache を意図的に省略する場合を除きます。例えば:
GET / HTTP/1.1
Host: www.example.com
Cache-Control: max-age=30
Pragma: no-cache
これは、HTTP/1.1 キャッシュに対して 30 秒より古くない応答を提供するよう制約しつつ、Cache-Control を理解しない実装がキャッシュされた応答を提供することを妨げます。
注: 応答における "Pragma: no-cache" の意味は規定されていないため、応答において "Cache-Control: no-cache" の信頼できる代替とはなりません。
5.5. Warning
"Warning" ヘッダーフィールドは、ステータスコードに反映されない可能性のある、メッセージの状態や変換に関する追加情報を伝えるために使用されます。この情報は通常、キャッシュ操作やメッセージのペイロードに適用された変換によってもたらされる可能性のある不正確さについて警告するために使用されます。
警告は、キャッシュ関連およびそれ以外の両方の、他の目的にも使用できます。エラーステータスコードではなく警告を使用することにより、これらの応答を真の失敗と区別できます。
Warning ヘッダーフィールドは一般に任意のメッセージに適用できますが、一部の warn-code はキャッシュに固有であり、応答メッセージにのみ適用できます。
Warning = 1#warning-value
warning-value = warn-code SP warn-agent SP warn-text
[ SP warn-date ]
warn-code = 3DIGIT
warn-agent = ( uri-host [ ":" port ] ) / pseudonym
; the name or pseudonym of the server adding
; the Warning header field, for use in debugging
; a single "-" is recommended when agent unknown
warn-text = quoted-string
warn-date = DQUOTE HTTP-date DQUOTE
応答内で複数の警告を生成できます (オリジンサーバーまたはキャッシュのいずれかによる)。warn-code 番号が同じで warn-text のみが異なる複数の警告も含まれます。
1 つ以上の Warning ヘッダーフィールドを受信したユーザーエージェントは、応答に現れる順序で、それらのできるだけ多くをユーザーに通知すべきです (SHOULD)。複数の Warning ヘッダーフィールドを生成する送信者は、このユーザーエージェントの動作を念頭に置いてそれらを並べることが推奨されます。新しい Warning ヘッダーフィールドを生成する送信者は、それらを既存の Warning ヘッダーフィールドの後に追加しなければならない (MUST)。
警告には 3 桁の warn-code が割り当てられます。最初の桁は、検証後にその Warning を格納された応答から削除する必要があるかどうかを示します:
-
1xx warn-code は、応答の新鮮度または検証状態を記述するものであり、したがって検証後にキャッシュによって削除されなければならない (MUST)。これらはキャッシュがキャッシュエントリを検証するときにのみ生成でき、それ以外のいかなる状況でも生成してはならない (MUST NOT)。
-
2xx warn-code は、検証によって是正されない表現のある側面 (例えば表現の非可逆圧縮) を記述するものであり、検証後にキャッシュによって削除されてはならない (MUST NOT)。ただし完全な応答が送信される場合はその限りではなく、その場合は削除されなければならない (MUST)。
送信者が、HTTP/1.0 のみを実装していることが分かっている受信者に送るメッセージ内で 1 つ以上の 1xx warn-code を生成する場合、送信者は、各対応する warning-value に、そのメッセージの Date ヘッダーフィールドと一致する warn-date を含めなければならない (MUST)。例えば:
HTTP/1.1 200 OK
Date: Sat, 25 Aug 2012 23:34:45 GMT
Warning: 112 - "network down" "Sat, 25 Aug 2012 23:34:45 GMT"
警告には、エラーを説明する warn-text が付随します (例えばログ記録用)。それは助言的なものにすぎず、その内容は warn-code の解釈に影響しません。
Warning ヘッダーフィールドを使用、評価、または表示する受信者が、同じメッセージ内の Date の値と異なる warn-date を受信した場合、受信者は、そのメッセージを格納、転送、または使用する前に、その warn-date を含む warning-value を除外しなければならない (MUST)。これにより、受信者は、キャッシュ検証後に不適切に保持された warning-value を除外できます。すべての warning-value が除外される場合、受信者は Warning ヘッダーフィールドも同様に除外しなければならない (MUST)。
本仕様は、以下の warn-code を定義します。それぞれに英語の推奨 warn-text とその意味の説明が付きます。追加の warn-code を定義する手順は、セクション 7.2.1 に記載されています。
5.5.1. Warning: 110 - "Response is Stale"
キャッシュは、送信する応答が古いときは常にこれを生成すべきです (SHOULD)。
5.5.2. Warning: 111 - "Revalidation Failed"
キャッシュは、サーバーに到達できないために応答の検証の試みが失敗した結果として古い応答を送信するとき、これを生成すべきです (SHOULD)。
5.5.3. Warning: 112 - "Disconnected Operation"
キャッシュが一定期間、意図的にネットワークの残りの部分から切断されている場合、キャッシュはこれを生成すべきです (SHOULD)。
5.5.4. Warning: 113 - "Heuristic Expiration"
キャッシュがヒューリスティックに 24 時間より大きい新鮮度ライフタイムを選択し、かつ応答の年齢が 24 時間より大きい場合、キャッシュはこれを生成すべきです (SHOULD)。
5.5.5. Warning: 199 - "Miscellaneous Warning"
警告テキストには、人間のユーザーに提示したりログに記録したりするための任意の情報を含めることができます。この警告を受信したシステムは、その警告をユーザーに提示する以外に、いかなる自動化された動作もとってはならない (MUST NOT)。
5.5.6. Warning: 214 - "Transformation Applied"
この Warning コードは、プロキシがその表現に何らかの変換 (内容コーディングやメディアタイプの変更、表現データの変更など) を適用する場合、その Warning コードがすでに応答に現れていない限り、プロキシによって追加されなければならない (MUST)。
5.5.7. Warning: 299 - "Miscellaneous Persistent Warning"
警告テキストには、人間のユーザーに提示したりログに記録したりするための任意の情報を含めることができます。この警告を受信したシステムは、いかなる自動化された動作もとってはならない (MUST NOT)。