キャッシュ

クラウドインフラストラクチャプロジェクト環境でキャッシュを有効にすることができます。 キャッシュを無効にした場合、Adobe Commerceはファイルを直接提供します。

キャッシュの設定

.magento/routes.yaml ファイルにキャッシュルールを設定して、アプリケーションのキャッシュを次のように有効にします。

http://{default}/:
    type: upstream
    upstream: php:php
    cache:
        enabled: true
        headers: [ "Accept", "Accept-Language", "X-Language-Locale" ]
        cookies: ["*"]
        default_ttl: 60

ルートベースのキャッシュ

次の例に示すように、複数のルートのキャッシュルールを別々に設定して、詳細なキャッシュを有効にします。

http://{default}/:
    type: upstream
    upstream: php:php
    cache:
        enabled: true

http://{default}/path/:
    type: upstream
    upstream: php:php
    cache:
        enabled: false

http://{default}/path/more/:
    type: upstream
    upstream: php:php
    cache:
        enabled: true

上記の例では、次のルートをキャッシュします。

また、次のルートは キャッシュされません。

キャッシュ時間

キャッシュ時間は、Cache-Control 応答ヘッダー値によって決まります。 応答に Cache-Control ヘッダーがない場合は、default_ttl キーが使用されます。

キャッシュキー

レスポンスをキャッシュする方法を決定するために、Adobe Commerceは、いくつかの要因に依存するキャッシュキーを作成し、そのキーに関連付けられたレスポンスを保存します。 リクエストに同じキャッシュキーが含まれる場合、応答は再利用されます。 その目的は HTTP Vary ヘッダーに似ています。

パラメーター headers および cookies キーを使用すると、このキャッシュキーを変更できます。

これらのキーのデフォルト値は次のとおりです。

cache:
    enabled: true
    headers: ["Accept-Language", "Accept"]
    cookies: ["*"]

キャッシュ属性

enabled

true に設定した場合は、このルートのキャッシュを有効にします。 false に設定した場合は、このルートのキャッシュを無効にします。

headers

キャッシュキーが依存する必要がある値を定義します。

例えば、headers のキーが次のような場合：

cache:
    enabled: true
    headers: ["Accept"]

次に、Adobe Commerceは、Accept HTTP ヘッダーの値ごとに異なる応答をキャッシュします。

cookies

cookies キーは、キャッシュキーが依存する必要がある値を定義します。

例：

cache:
    enabled: true
    cookies: ["value"]

キャッシュキーは、リクエストの value cookie の値によって異なります。

cookies キーの値が ["*"] の場合は、特殊なケースが存在します。 この値は、cookie を持つリクエストによってキャッシュがバイパスされることを意味します。 これがデフォルト値です。

Cookie には次の制限があります。

default_ttl

応答に Cache-Control ヘッダーがない場合、default_ttl キーを使用してキャッシュ時間（秒単位）を定義します。 デフォルト値は 0 です。これは、何もキャッシュされないことを意味します。