Documentation Commerce Guide de configuration

Configuration des fronts et des types du cache

Dernière mise à jour : 23 juin 2026

Rubriques :
{"id":"dac87252-6066-4d6e-a9d2-f6d84c323de7"}

Créé pour :

{"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
{"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Un cache frontal est une interface entre les types de cache Commerce et le serveur principal de stockage du cache. Vous pouvez définir plusieurs fronts, chacun avec des paramètres de serveur principal différents, puis attribuer des types de cache spécifiques à chaque front-end.

Utilisez cette relation pour décider où chaque type de cache stocke les données :

cache type -> cache frontend -> cache backend

Cela s’avère utile lorsque vous souhaitez utiliser différents serveurs principaux de cache ou des configurations pour différents types de données mises en cache. Par exemple, vous pouvez attribuer le type de cache full_page à un front-end page_cache qui utilise une base de données Valkey dédiée, tandis que d’autres types de cache utilisent le front-end default.

NOTE

Pour les projets Adobe Commerce on Cloud, consultez Bonnes pratiques relatives à la configuration du service Redis and Valkey pour obtenir des instructions sur la configuration du cache.

Utiliser le serveur frontal par défaut

Commerce fournit une interface de cache default qui fonctionne pour tous les types de cache. Il étend Zend_Cache_Core en implémentant le cache frontal Magento\Framework\Cache\Core.

Dans la plupart des cas, vous n’avez pas besoin de personnaliser le serveur frontal. Il vous suffit de configurer le serveur principal. Voir Options du serveur principal de cache.

Définition d’un fichier frontal de cache personnalisé

Les étapes suivantes expliquent comment associer un serveur frontal de cache à un type de cache.

Étape 1 : définir un cache frontal et attribuer des types de cache

Pour définir un front-end de cache personnalisé, ajoutez la configuration à app/etc/env.php (qui remplace di.xml) :

'cache' => [
    'frontend' => [
        '<unique frontend id>' => [
             <cache options>
        ],
    ],
    'type' => [
         <cache type 1> => [
             'frontend' => '<unique frontend id>'
        ],
         <cache type 2> => [
             'frontend' => '<unique frontend id>'
        ],
    ],
],

Où :

<unique frontend id> : nom unique permettant d’identifier le serveur frontal (par exemple, default, page_cache, stale_cache_enabled)
<cache options> : type de serveur principal et options de ce serveur frontal (voir Options de cache).
<cache type> : type de cache Commerce à affecter à ce serveur frontal (par exemple, config, layout, block_html, full_page)

TIP

Adobe Commerce 2.4.9 et les versions ultérieures utilisent des noms de type back-end simplifiés, tels que valkey ou file, avec l’implémentation de Symfony Cache. Consultez Options de cache du serveur principal pour obtenir des exemples de serveur principal et des conseils spécifiques à la version.

Étape 2 : configurer les options frontales et principales

Vous pouvez spécifier les options de configuration du cache front-end et back-end dans env.php ou di.xml. Cette tâche est facultative. Si vous ne spécifiez pas d’options, Commerce utilise les paramètres frontaux et principaux par défaut.

env.php exemple :

'frontend' => <frontend_type>,
'frontend_options' => [
    <frontend_option> => <frontend_option_value>,
    ...
],
'backend' => <backend_type>,
'backend_options' => [
    <backend_option> => <backend_option_value>,
    ...
],

Où :

<frontend_type> : type de cache front-end de bas niveau. Spécifiez un nom de classe compatible avec Zend\Cache\Core.
Si cet attribut est omis, 🔗 est utilisé.
<frontend_option>, <frontend_option_value> : nom et valeur des options que le framework Commerce transmet sous forme de tableau associatif au cache front-end lors de la création.
<backend_type> : type de cache du serveur principal de bas niveau. Vous pouvez spécifier les éléments suivants :
- Modern Symfony Cache (2.4.9+, recommandé) : noms simplifiés comme valkey ou file
- Hérité (basé sur Zend) : nom de classe complet compatible avec les Zend_Cache_Backend qui implémentent Zend_Cache_Backend_Interface
<backend_option>, <backend_option_value> : le nom et la valeur des options que le framework Commerce transmet sous forme de tableau associatif au cache du serveur principal lors de la création.

NOTE

Implémentation héritée ou moderne :

Hérité (basé sur Zend) : 'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis'
Modern (Symfony Cache) : 'backend' => 'valkey' pour les versions 2.4.9 et ultérieures de Commerce et les versions de correctifs actuelles pour les lignes de version 2.4.5 à 2.4.8, où Valkey est le serveur principal de cache pris en charge.

L’implémentation moderne de Symfony Cache offre de meilleures performances grâce à la conformité PSR-6, la sérialisation Igbinary, la compression gzip, les scripts Lua et les connexions persistantes.

Voir la Documentation Laminas pour obtenir des options basées sur Zend. Pour la configuration du cache Symfony, consultez les articles Redis et Valkey dans cette documentation.

recommendation-more-help

commerce-operations-help-configuration