HTTPキャッシュ制御ヘッダービルダー

HTTPキャッシュ制御ヘッダービルダーとは

Cache-ControlはHTTPレスポンスヘッダーで、ブラウザ、CDN、プロキシにレスポンスをキャッシュ可能か、期間、古くなった後の再検証方法を伝えます。最も誤りやすいヘッダーの1つです。no-cacheは「キャッシュしないこと」を意味しません。no-storeは一緒に設定した他のほぼすべてを静かに上書きします。s-maxageは共有キャッシュのみに関係し、max-ageは両方に関係します。このツールは個別のディレクティブ（またはキュレーションされたプリセット）から正しいヘッダーを組み立て、平易な言語で各アクティブディレクティブが正確に何をするかを説明します。矛盾したり部分的に相互にキャンセルする組み合わせもフラグを立てます。

使用方法

1. 一般的なシナリオ向けのContext Presetを選択します。APIレスポンス、静的アセット、HTMLページ、またはプライベートデータ。またはCustomのままディレクティブを手動で切り替えます。
2. カスタムモードで、適用可能なCacheabilityディレクティブをチェックします（public、private、no-cache、no-store）。Freshnessの有効期間を秒単位で設定します（max-age、s-maxage、stale-while-revalidate、stale-if-error）。必要なRevalidationディレクティブを有効化します（must-revalidate、proxy-revalidate、immutable、no-transform、must-understand）。
3. Cache-Control Headerボックスは自動的に更新されます。サーバー設定、CDNルール、またはアプリケーションコードに直接コピーします。
4. What Each Directive Doesを読んで、有効化した各ディレクティブの平易な説明を確認します。Warningsで設定した他のディレクティブと矛盾または静かに相互にキャンセルする事項がないかチェックします。

プリセットの選択

• API response — no-store。誰にもキャッシュされてはいけない動的なリクエスト単位のデータ。
• Static asset — public, max-age=31536000, immutable。ハッシュまたはバージョン付きファイル名（app.a1b2c3.js）のファイル用。URL自体が変わるときにコンテンツが変わるので、1年間キャッシュして再検証を完全にスキップするのは安全です。
• HTML page — no-cache。URLは同じでもコンテンツが変わる場合。キャッシュはそれを保存できますが、再度提供する前にオリジンで確認する必要があります。
• Private data — private, max-age=0, must-revalidate。アカウントページ、カート、ユーザー固有のもの。ブラウザのみでキャッシュ可能で、常に再検証されます。

FAQ

no-cacheとno-storeの違いは何ですか？

no-cacheはキャッシュがレスポンスを保存することを許可しますが、再度提供する前にオリジンサーバーで再検証を強制します。「最初にチェック」ディレクティブで、「キャッシュしないこと」ではありません。no-storeは厳密なバージョンです。キャッシュはレスポンスを保存できません。no-storeをmax-ageやmust-revalidateなどのディレクティブと混ぜることは無効ではありませんが、それらのディレクティブは無意味になります。no-storeはすでに保存を禁止しているため。

max-ageとs-maxageの違いは何ですか？

max-ageはすべてのキャッシュの鮮度有効期限を設定します。ブラウザと間にある共有キャッシュ（CDN、プロキシ）の両方。s-maxageはその有効期限を共有キャッシュのみでオーバーライドします。CDNでレスポンスをキャッシュする期間をブラウザより長く（または短く）設定できます。privateレスポンスのs-maxageは効果がありません。共有キャッシュはそもそもプライベートレスポンスの保存が許可されないため。

immutableはレスポンスが再検証されないことを意味しますか？

鮮度ウィンドウ内のみです。immutableはブラウザに、max-age（またはs-maxage）がレスポンスが新鮮だと言う間、ユーザーがトリガーしたリロードを含む条件付き再検証リクエストを完全にスキップできることを伝えます。そのウィンドウが終わると、通常の再検証ルールが再び適用されます。max-age/s-maxageなしでimmutableを設定すると、適用される鮮度ウィンドウがありません。

Cache-Controlは必要な唯一のキャッシングヘッダーですか？

鮮度とストレージを制御するための主要なものです。ただしETagやLast-Modifiedなどのバリデーターは再検証リクエストに重要です。max-age期限切れ後にキャッシュがオリジンに返送して「変わりましたか？」と質問するものです。秒計算なしで使用可能なmax-age=値に期間を変換するには、Cache TTL Calculatorを使用します。クロスオリジンリクエストの同等のヘッダービルドワークフローについては、CORS Headers Builderを参照します。

プライバシー

このツールはブラウザで完全に実行されます。設定したディレクティブと値が当サーバーに送信または保存されることはありません。