Documentation Commerce Guide des systèmes d’administration

Gestion du cache

Dernière mise à jour : 5 mai 2025

Rubriques :
Cache

Créé pour :

Débutant
Intermédiaire
Administration
Leader

Le système de gestion du cache d’Adobe Commerce et de Magento Open Source permet d’améliorer facilement les performances de votre site. Chaque fois qu’une actualisation du cache est nécessaire, une notification s’affiche avec un lien vers la page Cache Management pour terminer l’actualisation.

Enregistrer l’attribut de produit - Mettre à jour le message du cache

La page Cache Management affiche le statut de chaque cache principal et de la balise qui lui est associée. Les grands boutons situés dans le coin supérieur droit peuvent être utilisés pour vider le cache ou l’espace de stockage dans le cache « Tout compris ». Au bas de la page, des boutons supplémentaires vous permettent de vider le cache des images de produits du catalogue et le cache JavaScript/CSS.

IMPORTANT

Lorsque des entités de catalogue sont modifiées, cela peut affecter d’autres pages et invalider plusieurs caches simultanément. Lorsque vous examinez la page de gestion du cache, vous pouvez voir les éléments non valides qui doivent être actualisés lorsqu’ils n’ont  été modifiés directement . Par exemple, cette invalidation se produit lorsque vous modifiez un produit du catalogue affecté à une catégorie ou lorsque vous modifiez une règle de produit associée.

Après avoir effacé un cache, actualisez toujours votre navigateur pour vous assurer que vous pouvez voir les fichiers les plus récents. L’effacement du cache de Commerce n’efface pas le cache du navigateur web. Vous devrez peut-être vider la mémoire cache du navigateur pour afficher le contenu mis à jour.

Des informations techniques supplémentaires sur la mise en cache d’Adobe Commerce sont disponibles à partir de la présentation du cachedans le Guide de développement du front-end de Commerce.

Accédez à la page Cache Management en effectuant l’une des opérations suivantes :

Cliquez sur le lien Cache Management dans le message au-dessus de l’espace de travail.
Dans la barre latérale Admin, accédez à System > Tools>Cache Management.

Gestion du cache

Bonnes pratiques de mise en cache

La réindexation et la mise en cache ont des objectifs différents dans Commerce. Index suivez les informations de la base de données pour améliorer les performances de recherche, accélérer la récupération des données pour les vitrines, etc. Les caches enregistrent les données chargées, les images, les formats, etc. pour améliorer les performances de chargement et d’accès au storefront.

Videz toujours le cache après l’installation des extensions/modules. Vous pouvez installer une ou plusieurs extensions, puis vider le cache.
Videz le cache après l’installation de Commerce. Pour les nouvelles installations, vous devez également procéder à la réindexation.
Videz le cache après la mise à niveau d’une version d’Open Source ou de Commerce vers une autre.
Lors du vidage des caches, tenez compte du type de cache et planifiez le vidage en dehors des heures de pointe. Par exemple, choisissez une heure à laquelle peu de clients utilisent le site, comme tard dans la nuit ou tôt le matin. L’effacement des types de cache pendant la demande de pointe peut augmenter la charge sur l’administrateur et entraîner l’arrêt du site jusqu’à la fin de l’opération.
Lors de la réindexation, il n’est pas nécessaire de vider le cache.

Ressources du rôle de gestion du cache

Vous pouvez attribuer l’accès à des actions de maintenance de cache spécifiques aux utilisateurs par rôle, y compris les options d’affichage, de basculement et de vidage des caches. Adobe recommande d’activer les actions de vidage uniquement pour les utilisateurs de niveau administrateur. Donner accès à toutes les fonctionnalités de gestion du cache peut avoir un impact sur les performances de votre storefront.

Ressources de rôle - gestion du cache

Pour plus d’informations sur l’affectation de ressources pour accorder l’accès aux comptes utilisateur d’administration, voir Ressources de rôle. Les ressources suivantes contrôlent l’accès aux outils de gestion du cache :

Clean Cache Actions
- Flush Cache Storage
- Flush Magento Cache
Cache Type Management
- Toggle Cache Type
- Refresh Cache Type
Additional Cache Management
- Catalog Images Cache
- Flush Js/Css
- Flush Static Files

Actualiser les caches spécifiques

Pour chaque cache à actualiser, cochez la case au début de la ligne.
Définissez Actions sur Refresh, puis cliquez sur Submit.

Effectuer une actualisation en masse

Pour sélectionner un groupe de caches, définissez Mass Actions sur l’une des valeurs suivantes :
- Select All
- Select Visible
Cochez la case de chaque cache à actualiser.
Définissez Actions sur Refresh, puis cliquez sur Submit.

Videz le cache d’images du produit.

Sous Additional Cache Management, cliquez sur Flush Catalog Images Cache pour effacer les fichiers image de produit prégénérés.

Le message Image cache was cleaned s’affiche en haut de l’espace de travail.
Effacez le cache de votre navigateur.

Videz le cache JavaScript/CSS.

Sous Additional Cache Management, effacez les fichiers Javascript et CSS qui ont été fusionnés en un seul fichier en cliquant sur Flush JavaScript/CSS Cache.

Le message The JavaScript/CSS cache has been cleaned s’affiche en haut de l’espace de travail.
Effacez le cache de votre navigateur.

Vider à l’aide de la ligne de commande

Les administrateurs système et les développeurs ayant accès au serveur d’applications Commerce peuvent également gérer la configuration du cache et du cache à partir de la ligne de commande à l’aide de l’interface de ligne de commande Commerce. Voir Gestion du cachedans le Guide de configuration.

Contrôles

Contrôle

Description

Mass Actions

Coche la case de plusieurs caches. Options :
Select All— Coche la case de tous les caches.
 Tout désélectionner — Décoche la case de tous les caches.
Select Visible : coche la case de tous les caches visibles.
Unselect Visible— Décoche la case de tous les caches visibles.

Actions

Détermine l'action à appliquer à tous les caches sélectionnés. Options :
Enable— Active tous les caches sélectionnés.
Disable — Désactive tous les caches sélectionnés.
Refresh— Actualise tous les caches sélectionnés.

Submit

Applique l’action à tous les caches sélectionnés.

Boutons

Bouton

Description

Flush Magento Cache

Supprime tous les éléments du cache Commerce par défaut (var/cache) en fonction des balises Commerce associées.

Flush Cache Storage

Supprime tous les éléments du cache, quelle que soit la balise Commerce. Si votre système utilise un autre emplacement de cache, tous les fichiers mis en cache utilisés par d’autres applications sont supprimés dans le processus.

Flush Catalog Images Cache

Supprime toutes les images de catalogue automatiquement redimensionnées et filigranées stockées dans media/catalog/product/cache. Si les images récemment chargées ne sont pas reflétées dans le catalogue, essayez de vider le catalogue et d’actualiser votre navigateur.

Flush JavaScript/CSS Cache

Supprime la copie fusionnée des fichiers JavaScript et CSS du cache. Si des modifications récentes apportées à la feuille de style ou à JavaScript ne sont pas répercutées dans le magasin, essayez de vider le cache JavaScript/CSS et d’actualiser votre navigateur.

Flush Static Files Cache

Supprime les fichiers de vue prétraités et les fichiers statiques.

Caches

La page Cache Management répertorie les types de cache que vous pouvez gérer à partir de l’administration avec leur statut actuel. Cette section décrit les types de cache par défaut pris en charge par Adobe Commerce. Les colonnes Balise de cache et ID de cache décrivent les valeurs utilisées dans le code de l’application Commerce :

cache_type_id définit l’identifiant unique d’un type de cache.
%CACHE_TYPE_TAG% définit la balise unique à utiliser dans la définition de la portée du type de cache.

Les développeurs et les intégrateurs système utilisent ces valeurs pour configurer et gérer la mise en cache lors de la personnalisation ou de l’intégration à Adobe Commerce, par exemple pour développer des intégrations à l’aide des API GraphQL.

PaaS uniquement Le cache_type_id est également utilisé pour la gestion du cache à partir de la ligne de commande du serveur d’applications à l’aide de l’interface de ligne de commande Commerce. Par exemple, bin/magento cache:status config affiche le statut actuel du cache de configuration.

NOTE

Les développeurs et les intégrateurs système peuvent personnaliser et étendre le système de gestion du cache de Commerce pour prendre en charge les modules et intégrations personnalisés. Pour plus d’informations, consultez Configuration de la mise en cache dans le Guide de configuration d’Adobe Commerce.

Détails de la liste de cache

Cache

Description

Balise de cache

ID du cache

Configuration

Commerce collecte la configuration XML de tous les modules, la fusionne et enregistre le résultat fusionné dans le cache.
System- config.xml,local.xml
Module - config.xml

Ce cache contient également les paramètres spécifiques au magasin stockés dans le système de fichiers et la base de données. Nettoyez ou videz ce type de cache après avoir modifié les fichiers de configuration.

CONFIG

config

Layouts

Dispositions de page compilées, c’est-à-dire les composants de disposition de tous les composants. Nettoyez ou videz ce type de cache après avoir modifié les fichiers de disposition.

LAYOUT_GENERAL_CACHE_TAG

layout

Blocks HTML output

Fragments de page HTML par bloc Nettoyez ou videz ce type de cache après avoir modifié le calque d’affichage.

BLOCK_HTML

block_html

Collections Data

Fichiers de données de collection qui stockent les résultats des requêtes de base de données. Si nécessaire, Commerce nettoie automatiquement ce cache, mais les développeurs tiers peuvent placer n’importe quelle donnée de n’importe quel segment du cache. Nettoyez ou videz ce type de cache si votre module personnalisé utilise une logique qui entraîne des entrées de cache que Commerce ne peut pas nettoyer.

COLLECTION_DATA

collections

Reflections

Efface les données de réflexion de l’interface API, généralement générées pendant l’exécution.

REFLECTION

reflection

Database DDL operations

Schéma de la base. Si nécessaire, Commerce nettoie automatiquement ce cache, mais les développeurs tiers peuvent placer n’importe quelle donnée de n’importe quel segment du cache. Nettoyez ou videz ce type de cache après avoir apporté des modifications personnalisées au schéma de base de données. (En d’autres termes, il s’agit de mises à jour que Commerce ne fait pas lui-même.) Une façon de mettre à jour automatiquement le schéma de base de données est d’utiliser la commande setup

upgrade de Magento.

DB_DDL

db_ddl

Compiled Config

Résultats de la compilation de code.

COMPILED_CONFIG

compiled_config

Webhooks Response Cache

Met en cache les réponses aux requêtes webhook. Pour plus d’informations, consultez le guide des Webhooks dans la documentation du développeur de Commerce.

WEBHOOKS_RESPONSE

webhooks_response

EAV types and attributes

Met en cache la déclaration des types d’entités pour les métadonnées liées aux attributs de valeur d’attribut d’entité (EAV). Les attributs incluent les étiquettes de magasin, les liens vers le code PHP associé, le rendu des attributs, les paramètres de recherche, etc. En règle générale, il n’est pas nécessaire de nettoyer ou de vider ce type de cache.

EAV

eav

Customer Notification

Notifications temporaires qui apparaissent dans l’interface utilisateur d’.

CUSTOMER_NOTIFICATION

customer_notification

GraphQL Query Resolver Results

Met en cache les résultats des résolveurs de requêtes GraphQL pour les entités client, page CMS, bloc CMS et galerie de médias produit. Gardez ce cache activé pour améliorer les performances de GraphQL.

GRAPHQL_QUERY_RESOLVER_RESULT

graphql_query_resolver_result

Integrations Configuration

Fichier de configuration de l'intégration. Nettoyez ou videz ce cache après avoir modifié ou ajouté des intégrations.

INTEGRATION

config_integration

Integrations API Configuration

Configuration des API d’intégration compilée pour les intégrations de magasin.

INTEGRATION_API_CONFIG

config_integration_api

Admin UI SDK Cache

Met en cache les personnalisations pour l’administrateur. Voir Configuration et test d’administration dans le Guide SDK de l’interface utilisateur d’administration.

ADMIN_UI_SDK

admin_ui_sdk

Page Cache

Mise en cache complète de la page.

FPC

full_page

Target Rule

Index de règle cible

TARGET_RULE

target_rule

Web Services Configuration

Mise en cache de la structure de l’API Web.

WEBSERVICE

config_webservice

Translations

Fichiers de traduction.

TRANSLATE

translate

Mise en cache de toutes les pages

Adobe Commerce et Magento Open Source utilisent la mise en cache complète des pages sur le serveur pour afficher rapidement les pages de catégories, de produits et de CMS. La mise en cache de toutes les pages améliore le temps de réponse et réduit la charge sur le serveur. Sans mise en cache, chaque page peut avoir besoin d’exécuter des blocs de code et de récupérer des informations de la base de données. Toutefois, lorsque la mise en cache de toutes les pages est activée, une page entièrement générée peut être lue directement à partir du cache.

NOTE

Il est recommandé de n’utiliser le cache de vernis que dans un environnement de production.

Le contenu mis en cache peut être utilisé pour traiter les requêtes provenant de types de visites similaires. Par conséquent, les pages présentées à un visiteur occasionnel peuvent différer des pages présentées à un client. À des fins de mise en cache, chaque visite est l’un des trois types suivants :

Non-sessioned - Pendant une visite sans session, l’acheteur consulte les pages, mais n’interagit pas avec le magasin. Le système met en cache le contenu de chaque page consultée et les diffuse à d’autres acheteurs non connectés.
Sessioned - Lors d’une visite en session, un ID de session est attribué aux acheteurs qui interagissent avec le magasin. Les interactions incluent des activités telles que la comparaison de produits ou l’ajout de produits au panier. Les pages mises en cache générées au cours de la session ne sont utilisées que par cet acheteur au cours de la session.
Customer - Les sessions client sont créées pour les clients qui se connectent et font des achats à l’aide de leur compte enregistré. Au cours de la session, les clients peuvent recevoir des offres spéciales, des promotions et des prix en fonction du groupe de clients qui leur est affecté.

Pour obtenir des informations techniques, consultez les sections Configurer et utiliser le vernis et Utiliser Redis pour la page Commerce et le cache par défaut dans le Guide de configuration.

Pour configurer le cache de pages complètes, procédez comme suit

Dans la barre latérale Admin, accédez à Stores > Settings>Configuration.
Dans le panneau de gauche, développez Advanced et choisissez System.
Développez la section Full Page Cache .
Définissez Caching Application sur l’une des options suivantes :
- Built-in Application
- Varnish Caching
Pour définir le délai d’expiration du cache de page, saisissez le TTL for public content . (La valeur par défaut est 86400)
Pour spécifier le nombre maximal de handles de mise en page à traiter sur le point d’entrée HTTP {BASE-URL}/page_cache/block/esi, saisissez le Handles param size . Limiter la taille peut améliorer la sécurité et les performances. (La valeur par défaut est 100)
Si vous utilisez le vernis, complétez la section Varnish Configuration comme suit :
- Access list - Saisissez les adresses IP qui peuvent purger la configuration du vernis pour générer un fichier de configuration. Séparez les entrées multiples par une virgule. La valeur par défaut est localhost.
- Backend host - Saisissez l’adresse IP de l’hôte principal qui génère les fichiers de configuration. La valeur par défaut est localhost.
- Backend port - Identifiez le port principal utilisé pour générer les fichiers de configuration. La valeur par défaut est : 8080.
- Grace period - Spécifiez le nombre de secondes à utiliser comme période de grâce pour générer les fichiers de configuration. Voir Configuration avancée du vernis dans le Guide de configuration.
- Pour exporter la configuration sous la forme d’un fichier varnish.vcl, cliquez sur le bouton correspondant à la version de vernis que vous utilisez.
Cliquez ensuite sur Save Config.

recommendation-more-help