Cache-Control

Cache-Control 一般ヘッダーフィールドは、リクエストとレスポンスの両方のキャッシュ規則を指定するために用います。キャッシュのディレクティブは単一方向であり、すなわちリクエストで指定されたディレクティブがレスポンスで同じディレクティブが指定されたものとはみなされません。

構文

ディレクティブは大文字と小文字の区別をせず、任意の引数を持つことができ、そこには、トークンや quoted-string (複数の単語を""で囲んだ文字列) の書式形式で使用できます。複数のディレクティブはコンマで区切ります。

リクエスト時のキャッシュ指定について

クライアントからの HTTP リクエストで使用される可能性がある、標準的な Cache-Control ディレクティブです。

Cache-Control: max-age=<seconds>
Cache-Control: max-stale[=<seconds>]
Cache-Control: min-fresh=<seconds>
Cache-Control: no-cache 
Cache-Control: no-store
Cache-Control: no-transform
Cache-Control: only-if-cached

レスポンス時のキャッシュ指定について

サーバーからの HTTP リクエストで使用される可能性がある、標準的な Cache-Control ディレクティブです。

Cache-Control: must-revalidate
Cache-Control: no-cache
Cache-Control: no-store
Cache-Control: no-transform
Cache-Control: public
Cache-Control: private
Cache-Control: proxy-revalidate
Cache-Control: max-age=<seconds>
Cache-Control: s-maxage=<seconds>

Cache-Control ディレクティブの拡張

Cache-Control ディレクティブの拡張は、主な HTTP のキャッシュ標準ドキュメントには含まれていません。詳しくは、互換性一覧表をご確認ください。

Cache-Control: immutable 
Cache-Control: stale-while-revalidate=<seconds>
Cache-Control: stale-if-error=<seconds>

ディレクティブ

キャッシュ可能性

public

レスポンスが通常キャッシュ不可能なものであった (例えば、レスポンスに max-age ディレクティブや Expires ヘッダーが含まれていなかった) としても、レスポンスを任意のキャッシュがキャッシュして良いことを示します。

private

この場合のレスポンスは単一ユーザー向けであり、共有キャッシュに保存してはいけないことを示します。プライベートキャッシュにはレスポンスを保持することができます。

no-cache

キャッシュコピーをリリースする前に、検証のために元のサーバーへリクエストを送ることをキャッシュに強制します。

no-store

クライアントのリクエストであるかサーバーのレスポンスであるかにかかわらず、キャッシュを格納してはいけません。

有効期限

max-age=<seconds>

リソースが新しいとみなされる最長の時間を指定します。 Expires とは対照的に、このディレクティブはリクエスト時刻からの相対時間です。

s-maxage=<seconds>

max-age または Expires ヘッダーよりも優先しますが、共有キャッシュ (プロキシなど) でのみ適用され、プライベートキャッシュでは無視されます。

max-stale[=<seconds>]

Indicates that the client is willing to accept a response that has exceeded its expiration time. Optionally, you can assign a value in seconds, indicating the time the response must not be expired by.

min-fresh=<seconds>

Indicates that the client wants a response that will still be fresh for at least the specified number of seconds.

stale-while-revalidate=<seconds> 

Indicates that the client is willing to accept a stale response while asynchronously checking in the background for a fresh one. The seconds value indicates for how long the client is willing to accept a stale response. See "Keeping things fresh with stale-while-revalidate" for more information.

stale-if-error=<seconds> 

Indicates that the client is willing to accept a stale response if the check for a fresh one fails. The seconds value indicates for how long the client is willing to accept the stale response after the initial expiration.

再検証と再読み込み

must-revalidate

Indicates that once a resource has become stale (e.g. max-age has expired), a cache must not use the response to satisfy subsequent requests for this resource without successful validation on the origin server.

proxy-revalidate

Same as must-revalidate, but it only applies to shared caches (e.g., proxies) and is ignored by a private cache.

immutable

Indicates that the response body will not change over time. The resource, if unexpired, is unchanged on the server and therefore the client should not send a conditional revalidation for it (e.g. If-None-Match or If-Modified-Since) to check for updates, even when the user explicitly refreshes the page. Clients that aren't aware of this extension must ignore them as per the HTTP specification. In Firefox, immutable is only honored on https:// transactions. For more information, see also this blog post.

その他

no-transform

No transformations or conversions should be made to the resource. The Content-Encoding, Content-Range, Content-Type headers must not be modified by a proxy. A non-transparent proxy or browser feature such as Google's Light Mode might, for example, convert between image formats in order to save cache space or to reduce the amount of traffic on a slow link. The no-transform directive disallows this.

only-if-cached

Indicates to not retrieve new data. This being the case, the server wishes the client to obtain a response only once and then cache. From this moment the client should keep releasing a cached copy and avoid contacting the origin-server to see if a newer copy exists.

例

キャッシュの防止

キャッシュをしないようにしたい場合は、以下のレスポンスヘッダーを送ることができます。加えて、 Expires 及び Pragma ヘッダーも参照してください。

Cache-Control: no-store

静的な資産のキャッシュ

For the files in the application that will not change, you can usually add aggressive caching by sending the response header below. This includes static files that are served by the application such as images, CSS files and JavaScript files, for example. In addition, see also the Expires header.

Cache-Control: public, max-age=31536000

仕様書

ブラウザーの互換性

関連情報

• HTTP キャッシュ FAQ
• Caching Tutorial for Web Authors and Webmasters
• Guide: Cache-Control for civilians
• Age
• Expires
• Pragma