Apache キャッシュポリシーの設定

開始する前に、必要な Apache モジュールが有効になっていることを確認します。

どのモジュールが読み込まれているかを確認します。

apachectl -M | grep -E "expires|headers"

出力には expires_module と headers_module が含まれるはずです。どちらかが欠けている場合は、有効にします。

• Debian / Ubuntu：

  sudo a2enmod headers expires
  sudo systemctl restart apache2

• CentOS / RHEL / Alibaba Cloud Linux：

モジュールは通常、デフォルトでコンパイルされています。モジュールが欠けている場合は、/etc/httpd/conf.modules.d/ を確認し、対応する LoadModule 行がコメントアウトされていないことを確認してから、Apache を再起動します。

  sudo systemctl restart httpd

すべての例では <IfModule> ガードを使用しているため、モジュールが存在しなくても Apache はエラーなしで起動します。お使いのコンテンツタイプに合わせて ExpiresByType 行を置き換えるか、拡張してください。

コンテンツタイプ別のキャッシュTTLの設定

単純な max-age ルールには mod_expires を使用し、完全な Cache-Control 制御が必要な場合は mod_headers を使用します。

mod_expires

<IfModule mod_expires.c>
    ExpiresActive On

    # すべてのコンテンツタイプのデフォルトTTL
    ExpiresDefault "access plus 1 day"

    # 画像：1か月間キャッシュ
    ExpiresByType image/jpeg "access plus 1 month"
    ExpiresByType image/png  "access plus 1 month"
    ExpiresByType image/gif  "access plus 1 month"
    ExpiresByType image/svg+xml "access plus 1 month"
    ExpiresByType image/webp "access plus 1 month"

    # CSSとJavaScript：1週間キャッシュ
    ExpiresByType text/css              "access plus 1 week"
    ExpiresByType application/javascript "access plus 1 week"

    # フォント：1年間キャッシュ
    ExpiresByType font/woff2 "access plus 1 year"
    ExpiresByType font/woff  "access plus 1 year"

    # HTMLとデータ：キャッシュしない
    ExpiresByType text/html        "access plus 0 seconds"
    ExpiresByType application/json "access plus 0 seconds"
</IfModule>

mod_headers の同等の設定

<IfModule mod_headers.c>
    # 画像
    <FilesMatch "\.(jpg|jpeg|png|gif|svg|webp)$">
        Header set Cache-Control "max-age=2592000, public"
    </FilesMatch>

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

    # フォント
    <FilesMatch "\.(woff|woff2)$">
        Header set Cache-Control "max-age=31536000, public, immutable"
    </FilesMatch>

    # HTMLとデータ：キャッシュしない
    <FilesMatch "\.(html|json)$">
        Header set Cache-Control "no-store"
    </FilesMatch>
</IfModule>

グローバルなデフォルトTTLの設定

コンテンツの大部分が静的な場合は、グローバルなデフォルトを設定し、必要に応じて特定のタイプを上書きします。

mod_expires

<IfModule mod_expires.c>
    ExpiresActive On
    ExpiresDefault "access plus 1 week"
</IfModule>

mod_headers の同等の設定

<IfModule mod_headers.c>
    Header set Cache-Control "max-age=604800, public"
</IfModule>

動的コンテンツのキャッシュ無効化

リクエストごとに変化するレスポンスを、CDN のエッジノードとブラウザーにキャッシュさせないようにします。

mod_expires

<IfModule mod_expires.c>
    ExpiresActive On
    ExpiresByType text/html        "access plus 0 seconds"
    ExpiresByType application/json "access plus 0 seconds"
</IfModule>

mod_headers の同等の設定

<IfModule mod_headers.c>
    <FilesMatch "\.(html|json|php)$">
        Header set Cache-Control "no-store"
    </FilesMatch>
</IfModule>