Mise en cache

Vous pouvez activer la mise en cache dans l’environnement de projet de votre infrastructure cloud. Si vous désactivez la mise en cache, Adobe Commerce diffuse directement les fichiers.

Configuration de la mise en cache

Activez la mise en cache de votre application en configurant les règles de mise en cache dans le fichier .magento/routes.yaml comme suit :

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

Mise en cache basée sur les itinéraires

Activez la mise en cache affinée en configurant les règles de mise en cache de plusieurs itinéraires séparément, comme le montre l’exemple suivant :

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

L’exemple précédent met en cache les itinéraires suivants :

Et les itinéraires suivants sont not mis en cache :

Durée du cache

La durée du cache est déterminée par la valeur de l’en-tête de réponse Cache-Control. Si aucun en-tête Cache-Control n’est présent dans la réponse, la clé default_ttl est utilisée.

Clé de cache

Pour décider comment mettre en cache une réponse, Adobe Commerce crée une clé de cache qui dépend de plusieurs facteurs et stocke la réponse associée à cette clé. Lorsqu’une requête est fournie avec la même clé de cache, la réponse est réutilisée. Son objectif est similaire à l’en-tête HTTP Vary.

Les paramètres headers et les clés cookies vous permettent de modifier cette clé de cache.

La valeur par défaut de ces clés est la suivante :

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

Attributs du cache

enabled

Lorsqu’elle est définie sur true, activez le cache pour cet itinéraire. Lorsqu’elle est définie sur false, désactivez le cache pour cet itinéraire.

headers

Définit les valeurs dont doit dépendre la clé de cache.

Par exemple, si la clé headers est la suivante :

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

Ensuite, Adobe Commerce met en cache une réponse différente pour chaque valeur de l’en-tête HTTP Accept.

cookies

La clé cookies définit les valeurs dont la clé de cache doit dépendre.

Par exemple :

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

La clé de cache dépend de la valeur du cookie value dans la requête.

Il existe un cas spécial si la clé cookies a la valeur ["*"]. Cette valeur signifie que toute requête avec un cookie contourne le cache. Il s’agit de la valeur par défaut.

Les cookies comportent les restrictions suivantes :

default_ttl

Si la réponse ne comporte pas d’en-tête Cache-Control, la clé default_ttl est utilisée pour définir la durée du cache, en secondes. La valeur par défaut est 0, ce qui signifie que rien n’est mis en cache.