Configuration de l’application Commerce pour utiliser le vernis

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Configuration
Cache

Créé pour :

Expérimenté
Administration
Développeur

Pour configurer Commerce afin d’utiliser le vernis :

Connectez-vous à l’administrateur en tant qu’administrateur.
Cliquez sur Stores > Paramètres > Configuration > Avancé > Système > Cache de page complet.
Dans la liste Caching Application, cliquez sur Mise en cache de vernis.
Saisissez une valeur dans le champ TTL for public content .

Développez Varnish Configuration et saisissez les informations suivantes :

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Champ	Description
Accéder à la liste	Entrez le nom d’hôte complet, l’adresse IP ou la plage d’adresses IP de notation CIDR (Classless Inter-domain Routing) pour laquelle invalider le contenu. Voir Purge du cache de vernis.
Hôte principal	Saisissez le nom d’hôte complet ou l’adresse IP et le port d’écoute du Varnish serveur principal ou serveur d’origine ; c’est-à-dire le serveur qui fournit le contenu que Varnish accélère. En règle générale, il s’agit de votre serveur web. Voir Serveurs principaux de cache vernis.
Port du serveur principal	Port d’écoute du serveur d’origine.
Délai de grâce	Détermine la durée pendant laquelle le vernis diffuse du contenu obsolète si le serveur principal ne répond pas. La valeur par défaut est de 300 secondes.
Gère la taille des paramètres	Indique le nombre maximal de handles de mise en page à traiter sur le point d’entrée HTTP `{BASE-URL}/page_cache/block/esi` pour la mise en cache de toutes les pages. Limiter la taille peut améliorer la sécurité et les performances. La valeur par défaut est 100.

Cliquez sur Enregistrer la configuration.

Vous pouvez également activer le vernis à partir de la ligne de commande, au lieu de vous connecter à Admin, à l’aide de l’outil d’interface de ligne de commande C :

bin/magento config:set --scope=default --scope-code=0 system/full_page_cache/caching_application 2

Exporter un fichier de configuration de vernis

Pour exporter un fichier de configuration de vernis à partir de l’administrateur :

Cliquez sur l’un des boutons d’exportation pour créer un varnish.vcl à utiliser avec le vernis.

Par exemple, si vous avez Vernis 4, cliquez sur Exporter VCL pour Vernis 4

La figure suivante en est un exemple :

Sauvegardez vos default.vcl existantes. Renommez ensuite le fichier varnish.vcl que vous venez d’exporter en default.vcl. Copiez ensuite le fichier dans le répertoire /etc/varnish/.

code language-bash
`cp /etc/varnish/default.vcl /etc/varnish/default.vcl.bak2`

code language-bash
`mv <download_directory>/varnish.vcl default.vcl`

code language-bash
`cp <download_directory>/default.vcl /etc/varnish/default.vcl`

Adobe vous recommande d’ouvrir default.vcl et de modifier la valeur de acl purge sur l’adresse IP de l’hôte Vernis. (Vous pouvez spécifier plusieurs hôtes sur des lignes distinctes ou vous pouvez également utiliser la notation CIDR.)

Par exemple,

code language-conf
`acl purge { "localhost"; }`

Si vous souhaitez personnaliser les contrôles de l’intégrité de Vagrant, la configuration du mode de grâce ou du mode saint, consultez Configuration avancée du vernis.

Redémarrez Varnish et votre serveur web :

code language-bash
`service varnish restart`

code language-bash
`service httpd restart`

Mettre en cache les fichiers statiques

Les fichiers statiques ne doivent pas être mis en cache par défaut, mais si vous souhaitez les mettre en cache, vous pouvez modifier la section Static files caching dans le VCL pour avoir le contenu suivant :

# Static files should not be cached by default
  return (pass);

# But if you use a few locales and do not use CDN you can enable caching static files by commenting previous line (#return (pass);) and uncommenting next 3 lines
  #unset req.http.Https;
  #unset req.http./* {{ ssl_offloaded_header }} */;
  #unset req.http.Cookie;

Vous devez effectuer ces modifications avant de configurer Commerce pour utiliser le vernis.

recommendation-more-help

386822bd-e32c-40a8-81c2-ed90ad1e198c