Web・開発

HTTPキャッシュの解説:Cache-Control、ETag、画像とApache設定

HTTP Caching Explained: Cache-Control, ETag, Images and Apache Configuration

HTML、CSS、JavaScript、画像、フォントのブラウザキャッシュ設定方法を学びます。ETagと304レスポンスを実例で理解し、古いファイルを防止し、完全なApache .htaccess構成を使用します。

HTTPキャッシュを解説:Cache-Control、ETag、画像、Apache設定

画像を最適化し、CSSを縮小し、JavaScriptを圧縮しています。Webサイトの読み込みは速くなります。しかし訪問者が再び戻ってきたとき、ブラウザが同じファイルを再びダウンロードする可能性があります。

キャッシュを有効にします。すべてが良くなったように見えます——画像を差し替えたあと、一部の訪問者にはまだ古い画像が表示されると気づくまでは。

これがHTTPキャッシュの課題です:変更されていないファイルは再利用し、変更されたときは新しいバージョンを取得する。

このガイドでは、Apache、PHP、ブラウザの開発者ツールを使って、実際のWebサイト向けのキャッシュ戦略を構築します。

1. 簡単な例でHTTPキャッシュを説明する

5つのファイルを持つWebサイトを想像してください:

index.html
assets/css/style.css
assets/js/app.js
assets/images/hero.webp
assets/fonts/site.woff2

誰かがあなたのWebサイトを初めて訪問すると、ブラウザはこれらのファイルをダウンロードします。

最初の訪問 — ブラウザはすべてを必要とする

ここで、その訪問者が10分後に戻ってきたとします。

サーバーが以前に、CSSファイルは1日間再利用できるとブラウザに伝えていた場合、ブラウザはそれを再びダウンロードする必要がありません。

ブラウザはすでにコピーを持っています。

これがキャッシュの基本的な考え方です。

指示は、サーバーのレスポンスとともに送信されるHTTPヘッダーから来ます。

例えば:

Cache-Control: public, max-age=86400

これは、レスポンスが86,400秒——1日間——フレッシュである間は再利用されてよいという意味です。

しかし、わずか1時間後にCSSを更新したらどうなるでしょうか?

ブラウザは残りの23時間、古いバージョンを使い続ける可能性があります。

だからこそ、単にキャッシュ期間を長くするだけでは不十分なのです。

2. Cache-Control:ブラウザに送られる指示

Cache-Control ヘッダーは、ブラウザやその他のHTTPキャッシュに、レスポンスをどのように扱うかを伝えます。

ここでは、最もよく使うディレクティブを示します。

ディレクティブ 簡単な説明
max-age=3600 最大1時間、レスポンスを再利用する
public CDNを含む共有キャッシュがレスポンスを保存してよい
private 共有キャッシュではなく、プライベートキャッシュにのみ保存する
no-cache 許可されていれば保存するが、再利用前に検証する
no-store レスポンスを保存しない
immutable フレッシュである間はリソースが変更されないと想定する
must-revalidate 一度古くなったら、検証に成功しない限り再利用しない

特に紛らわしいディレクティブの1つが no-cache です。

これは「このファイルを決して保存しない」という意味ではありません。

「保存されたコピーを使う前に、サーバーにそれがまだ有効かどうかを尋ねる」という意味です。

保存してはならないレスポンスには、no-store を使用してください。

この区別は、HTMLページや機密性の高いコンテンツを設定するときに重要です。

3. ETagを解説:ブラウザがファイルの変更をどうやって尋ねるか

具体的に見てみましょう。

logo.webp というファイルがあるとします。

ブラウザは月曜日にそれをダウンロードします。

サーバーは識別子も送信します:

ETag: "logo-version-1"

この識別子を、画像のその特定バージョンに付けられたラベルだと考えてください。

ブラウザは画像を保持し、ラベルを覚えておきます。

火曜日、キャッシュされたレスポンスには検証が必要です。ブラウザは画像全体をすぐに再ダウンロードする代わりに、こう尋ねます:

「こんにちはサーバー。私は logo-version-1 で識別される画像をすでに持っています。それはまだ同じですか?」

技術的には、次のものを送信します:

GET /images/logo.webp HTTP/1.1
Host: example.com
If-None-Match: "logo-version-1"

サーバーはその識別子を現在のバージョンと比較します。

ETag条件付きリクエスト:変更がなければ304、変更されていれば200

ケースA:画像が変更されていない場合

サーバーはこう返します:

HTTP/1.1 304 Not Modified
ETag: "logo-version-1"

ブラウザは実質的に「よし、既存の画像を使い続けよう」と考えます。

サーバーは画像本体を再び送信しません。

ケースB:画像が変更された場合

ロゴを新しいバージョンに差し替えたとします。

サーバーは今、それを logo-version-2 として識別します。

ブラウザはまだ logo-version-1 について尋ねますが、サーバーはこう返します:

HTTP/1.1 200 OK
Content-Type: image/webp
ETag: "logo-version-2"

今回は、レスポンスに新しい画像が含まれます。

ブラウザはキャッシュされたコピーを置き換えます。

ETagがキャッシュのために行うのはこれだけです。つまり、ブラウザが自分のコピーがまだ最新かどうかを確認できるようにします。

識別子はハッシュやバージョン番号である必要はありません。Apacheはファイルメタデータから生成することがあり、アプリケーションは独自の識別子を生成できます。

ETagを自分でテストする

まず、レスポンスヘッダーを取得します:

curl -I https://example.com/images/logo.webp

ETagを見つけます:

ETag: "abc123"

次に、条件付きリクエストを送信します:

curl -I \
  -H 'If-None-Match: "abc123"' \
  https://example.com/images/logo.webp

表現が変更されていなければ、正しく設定されたサーバーは 304 Not Modified を返せます。

変更されていれば、更新された表現とともに 200 OK を期待してください。

重要な制限が1つあります: ETagは、キャッシュされたレスポンスがまだフレッシュである間、ブラウザにサーバーへの問い合わせを強制するものではありません。画像のフレッシュ期間が1年ある場合、サーバー上でファイルを変更しても、ブラウザがすぐにそのETagを確認する保証はありません。

ここでリソースのバージョン管理が不可欠になります。

4. 画像キャッシュ:しばしば最も問題を引き起こす部分

画像はしばしば、Webサイト上で最大のリソースの1つです。

ホームページには、ヒーロー画像、カテゴリのイラスト、記事のサムネイル、ロゴ、アイコン、商品画像が含まれることがあります。

WebPやAVIFに圧縮されていても、それらを繰り返しダウンロードすると帯域幅を浪費します。

3つの実際の状況を検討しましょう。

状況A:決して変更されない画像

あなたのWebサイトには装飾用の画像があります:

/images/background-v1.webp

デザインが変わるときはいつでも、新しいファイル名を使うことは分かっています。

安全に次のように設定できます:

Cache-Control: public, max-age=31536000, immutable

ブラウザは、レスポンスがフレッシュである間はサーバーに問い合わせることなく、それを1年間再利用できます。

状況B:同じファイル名で置き換えられる画像

記事に次のものが含まれているとします:

<img src="/images/article-hero.webp" alt="Article illustration">

article-hero.webp を新しい画像に差し替えても、同じURLを維持します。

ブラウザが長い期間を持つフレッシュなキャッシュ済みレスポンスを持っている場合、古い画像を表示し続ける可能性があります。

修正方法は、コンテンツが変わったときにURLを変更することです。

例えば:

<img src="/images/article-hero.webp?v=2" alt="Article illustration">

または、より良い方法として、バージョン付きのファイル名を生成します:

<img src="/images/article-hero-a81c.webp" alt="Article illustration">

これでブラウザは異なるリソースURLを見て、新しい画像をリクエストします。

古いキャッシュ済み画像は、HTMLがそれを参照しなくなるため無害です。

同じURLで画像を置き換える場合と、新しいバージョン付きURLを使う場合

状況C:安定したファイル名を持つ数千の画像

数千の記事を含む編集系Webサイトを想像してください。

すべての画像の名前を手動で変更するのは不便です。

代わりに、1日や1週間といった適度なキャッシュ期間を選び、期限切れ後の再検証に頼ることができます。

例えば:

Cache-Control: public, max-age=86400

自動画像バージョン管理が利用できない場合、これは妥当な妥協案です。

ただし、訪問者はフレッシュ期間中に古い画像を見る可能性があります。

すぐに更新する必要がある画像には、URLの変更や明示的なキャッシュ無効化の方が望ましいです。

JPEG、PNG、SVG、WebP、AVIFはどうでしょうか?

キャッシュの原則はそれらすべてで同じです。

画像形式 一般的な用途 キャッシュ戦略
JPEG 写真 URLがバージョン管理されている場合は長いキャッシュ
PNG グラフィック、透過 同じ
WebP 最適化されたWeb画像 同じ
AVIF 高度に圧縮された画像 同じ
SVG アイコン、ロゴ、イラスト 同じ
GIF 単純なアニメーション 同じ

形式は圧縮とデコードに影響しますが、HTTPキャッシュの動作を根本的に変えるものではありません。

また、レスポンシブ画像は複数の独立したキャッシュエントリを生成する可能性があることを覚えておいてください:

<picture>
  <source
    type="image/avif"
    srcset="/images/hero-640.avif 640w,
            /images/hero-1280.avif 1280w">
  <source
    type="image/webp"
    srcset="/images/hero-640.webp 640w,
            /images/hero-1280.webp 1280w">
  <img
    src="/images/hero-1280.jpg"
    alt="Mountain landscape"
    width="1280"
    height="720">
</picture>

選択された各URLには、それぞれ独自のキャッシュ動作があります。

画像を差し替える場合は、関連するすべてのバリアントのURLを更新してください。

5. PHPでCSS、JavaScript、画像を自動的にバージョン管理する

PHPのWebサイトでは、ファイルの更新時刻を使うことで、バージョン番号を手動で更新することを避けられます。

小さなヘルパーは次のとおりです:

<?php

function assetUrl(string $path): string
{
    $file = $_SERVER['DOCUMENT_ROOT'] . $path;

    if(!is_file($file)) {
        return $path;
    }

    return $path . '?v=' . filemtime($file);
}

次のように使います:

<link rel="stylesheet" href="<?= htmlspecialchars(assetUrl('/assets/css/site.css'), ENT_QUOTES, 'UTF-8') ?>">

<img
    src="<?= htmlspecialchars(assetUrl('/assets/images/hero.webp'), ENT_QUOTES, 'UTF-8') ?>"
    alt="Hero image">

ファイルの更新タイムスタンプが 1794800000 だとします。

ブラウザは次のようなURLを受け取ります:

/assets/images/hero.webp?v=1794800000

ファイルを更新して更新時刻が変わると、URLも変わります。

これはシンプルなキャッシュバスティング戦略です。

本番ビルドパイプラインでは、タイムスタンプがデプロイ中に保持されたり、コンテンツが変わっていないのに変更されたりする可能性があるため、コンテンツハッシュの方が堅牢です。

重要: CDNがキャッシュキーでクエリ文字列を無視するように設定されている場合、?v= は別個のキャッシュ済みリソースを生成しない可能性があります。CDN設定を確認するか、代わりにバージョン付きファイル名を使用してください。

6. ブラウザキャッシュ、サーバーキャッシュ、CDNキャッシュを混同しない

Webサイトには複数のキャッシュ層があります。

ブラウザキャッシュは、訪問者のデバイス上にレスポンスを保存します。

CDNは、訪問者に地理的に近いサーバー上に選択されたレスポンスを保存します。

アプリケーションキャッシュは、生成されたHTML、データベースクエリの結果、その他の計算済みデータを保存できます。

これらの層は異なる問題を解決します。

例えば、ブラウザキャッシュをクリアした後でも、CDNが古い画像を配信する可能性があります。

同様に、CMSキャッシュをクリアしても、ブラウザやCDNによってすでに保存された画像が必ずしも無効になるわけではありません。

デバッグするときは、設定を変更する前に、どの層が古いコンテンツを配信しているかを特定してください。

7. ホスティング性能とHTTPキャッシュ

HTTPキャッシュは繰り返しのダウンロードを大幅に減らせますが、すべてのホスティング問題を補えるわけではありません。

例えば、遅いデータベースクエリのためにキャッシュされていないPHPページの生成に2秒かかる場合、画像のブラウザキャッシュでは根本的なサーバー応答時間は解決しません。

信頼できるホスティング環境は、適切なPHP性能、ストレージ、圧縮、TLS、およびキャッシュヘッダーのサポートを提供するべきです。

中小規模のWebサイトでは、PlanetHosterのようなホスティングプロバイダーが実用的な構成の一部になり得ます。

サーバーリソース、デプロイワークフロー、キャッシュアーキテクチャをより細かく制御する必要があるアプリケーションでは、Cloudwaysも検討する価値があるかもしれません。

プロバイダーを変更する前に、実際のボトルネックを測定してください:サーバー応答時間、画像の重さ、PHP実行、データベースクエリ、キャッシュ設定のいずれかです。

8. FirefoxとChromeでキャッシュを検査する方法

ブラウザの開発者ツールを開きます。

Firefoxでは F12 を押してから、ネットワークを選択します。

Webサイトを再読み込みし、画像またはスタイルシートのリクエストをクリックします。

そのレスポンスヘッダーを見ます。

例えば:

Cache-Control: public, max-age=86400
ETag: "abc123"
Last-Modified: Mon, 16 Nov 2026 09:00:00 GMT

次に、キャッシュを無効化せずにナビゲーションを繰り返します。

ブラウザ、リソースのフレッシュ度、ナビゲーションの開始方法によって、ローカルキャッシュから読み込まれるか、304 で再検証されるか、再びダウンロードされる可能性があります。

特定の画像を独立してテストするには:

curl -sS -D - -o /dev/null \
  https://example.com/assets/images/hero.webp

ステータス、Cache-Control、ETag、Last-Modified を確認します。

次に、サーバーが返した実際のETagを使って、If-None-Match 付きでリクエストを繰り返します。

強制リロードだけをキャッシュテストに使うのは避けてください。それはキャッシュされたレスポンスを意図的にバイパスしたり再検証したりする場合があります。

9. 実際のWebサイト向けの完全なApache .htaccess例

最後に、実用的な設定で締めくくりましょう。

この例は、静的ファイルとPHP生成のHTMLが混在する、Apache 2.4で動作する公開Webサイト向けに設計されています。

戦略は意図的に保守的にしています:

  • HTMLは再検証される。
  • CSSとJavaScriptは7日間のキャッシュを使用する。
  • 画像は7日間のキャッシュを使用する。
  • フォントはより長いキャッシュを使用する。
  • マニフェストファイルは短いキャッシュを使用する。
  • ETagは静的ファイルの検証に引き続き利用できる。
  • PHPレスポンスは独自のポリシーを設定できる。

これは開始用の設定であり、普遍的なそのまま使える代替品ではありません。デプロイする前に、ホスティングプロバイダーの既存ルール、有効なモジュール、Apacheの上書き権限を確認してください。

# ============================================================
# HTTP CACHING — APACHE 2.4
# Example configuration for a public website
# ============================================================

# ------------------------------------------------------------
# 1. Static file expiration
# ------------------------------------------------------------

<IfModule mod_expires.c>
    ExpiresActive On

    # Default: validate immediately
    ExpiresDefault "access plus 0 seconds"

    # HTML: validate before reuse
    ExpiresByType text/html "access plus 0 seconds"

    # CSS and JavaScript: 7 days
    ExpiresByType text/css "access plus 7 days"
    ExpiresByType text/javascript "access plus 7 days"
    ExpiresByType application/javascript "access plus 7 days"

    # Images: 7 days
    ExpiresByType image/jpeg "access plus 7 days"
    ExpiresByType image/png "access plus 7 days"
    ExpiresByType image/gif "access plus 7 days"
    ExpiresByType image/webp "access plus 7 days"
    ExpiresByType image/avif "access plus 7 days"
    ExpiresByType image/svg+xml "access plus 7 days"
    ExpiresByType image/x-icon "access plus 7 days"
    ExpiresByType image/vnd.microsoft.icon "access plus 7 days"

    # Fonts: 30 days
    ExpiresByType font/woff "access plus 30 days"
    ExpiresByType font/woff2 "access plus 30 days"
    ExpiresByType font/ttf "access plus 30 days"
    ExpiresByType font/otf "access plus 30 days"

    # Documents: 1 day
    ExpiresByType application/pdf "access plus 1 day"

    # JSON and XML: validate immediately by default
    ExpiresByType application/json "access plus 0 seconds"
    ExpiresByType application/xml "access plus 0 seconds"
    ExpiresByType text/xml "access plus 0 seconds"

    # Web manifest: 1 hour
    ExpiresByType application/manifest+json "access plus 1 hour"
</IfModule>

# ------------------------------------------------------------
# 2. Explicit Cache-Control for static resources
# ------------------------------------------------------------

<IfModule mod_headers.c>

    # HTML: allow storage, require validation
    <FilesMatch "\.html?$">
        Header set Cache-Control "no-cache"
    </FilesMatch>

    # CSS and JavaScript
    <FilesMatch "\.(css|js|mjs)$">
        Header set Cache-Control "public, max-age=604800"
    </FilesMatch>

    # Images
    <FilesMatch "\.(jpe?g|png|gif|webp|avif|svg|ico)$">
        Header set Cache-Control "public, max-age=604800"
    </FilesMatch>

    # Fonts
    <FilesMatch "\.(woff2?|ttf|otf)$">
        Header set Cache-Control "public, max-age=2592000"
    </FilesMatch>

    # PDF documents
    <FilesMatch "\.pdf$">
        Header set Cache-Control "public, max-age=86400"
    </FilesMatch>

    # Data files: revalidate
    <FilesMatch "\.(json|xml)$">
        Header set Cache-Control "no-cache"
    </FilesMatch>

    # Manifest files
    <FilesMatch "\.webmanifest$">
        Header set Cache-Control "public, max-age=3600"
    </FilesMatch>

</IfModule>

# ------------------------------------------------------------
# 3. ETag support for static files
# ------------------------------------------------------------

FileETag MTime Size

# ------------------------------------------------------------
# 4. Compression
# ------------------------------------------------------------

<IfModule mod_deflate.c>
    AddOutputFilterByType DEFLATE text/html
    AddOutputFilterByType DEFLATE text/plain
    AddOutputFilterByType DEFLATE text/css
    AddOutputFilterByType DEFLATE text/javascript
    AddOutputFilterByType DEFLATE application/javascript
    AddOutputFilterByType DEFLATE application/json
    AddOutputFilterByType DEFLATE application/xml
    AddOutputFilterByType DEFLATE image/svg+xml
</IfModule>

# ------------------------------------------------------------
# 5. Avoid caching sensitive PHP responses accidentally
# ------------------------------------------------------------

# Configure dynamic PHP responses in application code.
# Do not apply public caching globally to PHP endpoints.

この設定に関する重要な注意点

1. 既存のキャッシュ設定を重複させないこと。

ホスティングプロバイダー、CMS、キャッシュプラグインがすでにこれらのヘッダーを設定している場合は、ポリシーを慎重に統合してください。

Apacheの mod_expires は有効期限と max-age 情報を生成し、mod_headers は Cache-Control を明示的に設定できます。ヘッダーが内部的にどのように生成・保存されるかによって、両方を組み合わせると重複した値や競合する値が生じる可能性があります。

実際のHTTPレスポンスを検査し、必要なら設定を簡素化してください。本番デプロイでは、リソースクラスごとに一貫した1つの仕組みを選ぶ方が望ましいです。

2. ETagはすべてのレスポンスに必須ではない。

FileETag MTime Size ディレクティブはApacheが配信するファイルに適用されます。動的に生成されるPHPページに対して、自動的に意味のあるバリデータを提供するわけではありません。

分散サーバーでは、メタデータベースのETagに追加の考慮が必要になる場合もあります。

3. 圧縮は画像最適化ではない。

GzipはHTML、CSS、JavaScript、JSON、SVGなどのテキストベースのリソースに有用です。

JPEG、WebP、AVIF、PNGはすでに圧縮された形式です。追加のgzip圧縮は通常ほとんど効果がありません。

サーバーがすでにBrotliをサポートしている場合は、既存の設定を確認せずに競合する圧縮設定を追加するのは避けてください。

4. 7日間は妥協案である。

すべての静的アセットに信頼できるバージョン付きURLがある場合は、キャッシュ期間を1年に延ばし、immutable を使用できます。

URLを変更せずに画像を日常的に差し替えている場合、7日間でもまだ長すぎるかもしれません。

Webサイトのデプロイ方法に基づいてポリシーを選んでください。

10. デプロイ前後に設定をテストする

このチェックリストを使用してください。

テスト 期待される結果
画像をリクエストする Cache-Control が画像ポリシーを反映している
スタイルシートをリクエストする 正しいCSSキャッシュポリシー
HTMLをリクエストする 再検証ポリシー
プライベートページをリクエストする 意図しない共有キャッシュがない
If-None-Match を送信する 変更がなく検証がサポートされていれば 304
バージョン付き画像を置き換える 新しいURLが新しい画像を読み込む
圧縮されたCSSを検査する 適切なContent-Encoding
ブラウザのNetworkパネルを確認する 予期しない完全な再ダウンロードがない

例えば:

curl -I https://example.com/assets/images/hero.webp

次に:

curl -I https://example.com/assets/css/site.css

そして最後に:

curl -I https://example.com/

レスポンスヘッダーを比較してください。

ファイルに期待されるキャッシュヘッダーがない場合は、Apacheが実際にそのファイルを配信しているか、関連モジュールが有効か、CDNやアプリケーション層がレスポンスを上書きしていないかを確認してください。

.htaccess を編集した後にサイトが 500 Internal Server Error を返す場合は、以前の設定に戻し、Apacheエラーログを検査してください。サポートされていないディレクティブや許可されていない上書きがよくある原因です。

11. CDNやマネージドホスティングが役立つ場合

異なる国に訪問者がいるWebサイトでは、CDNはユーザーとキャッシュされた静的リソースの間の距離を縮められます。

ただし、CDNを追加することが自動的に改善になるわけではありません。

まず、画像が正しいサイズにされ、圧縮されていること、ブラウザキャッシュが機能していること、静的リソースのURLがバージョン管理されていることを確認してください。

次に、CDNが実環境の配信時間を改善するかどうかを測定します。

適切なキャッシュ制御を備えたホスティングプラットフォームはこの設定を簡素化できますが、それでも各レスポンスに対してどのキャッシュ層が責任を持つかを理解しておくべきです。

PlanetHosterとCloudwaysは、アプリケーションの要件、運用上のニーズ、利用可能なサーバー制御に応じて評価する価値のある2つのホスティング選択肢です。

重要な問題は、どのプロバイダーが最も多くのキャッシュ機能を宣伝しているかではありません。キャッシュされたコンテンツを確実に設定、測定、無効化できるかどうかです。

結論

3つの問いを切り分ければ、HTTPキャッシュの管理はずっと簡単になります:

このレスポンスは保存できるか? 確認せずにどのくらい再利用できるか? ブラウザは変更されたかどうかをどうやって知るのか?

Cache-Control は最初の2つの問いに答えます。

ETagと条件付きリクエストは3つ目の問いに答える助けになります。

画像、CSS、JavaScriptなどの静的アセットでは、バージョン付きURLが長いキャッシュ期間と即時更新を両立させる最も信頼できる方法であることがよくあります。

HTMLや頻繁に変更されるコンテンツでは、通常は再検証の方が適切です。

保守的な設定から始め、実際のHTTPリクエストでテストし、Webサイトが更新をどのように扱うかを理解してから初めてキャッシュ期間を延ばしてください。