Documentation Commerce Guide de configuration

[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Configuration du cache L2 pour l’optimisation des performances

Last update: Fri May 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Configuration
Cache

Créé pour :

Expérimenté
Administration
Développeur

La mise en cache L2 (à deux niveaux) réduit le trafic réseau entre le stockage de cache distant (Redis ou Valkey) et l’application Commerce en ajoutant une couche de cache locale sur chaque nœud web. Une instance Commerce standard transfère environ 300 Ko par requête et le trafic peut rapidement passer à plus de 1 000 requêtes dans certains cas.

Avec la mise en cache L2, chaque nœud web stocke localement les données fréquemment consultées et utilise le cache distant à deux fins :

Vérification de la version des données du cache pour s’assurer que le dernier cache est stocké localement
Transfert des données de cache mises à jour du magasin distant vers l'ordinateur local

Commerce stocke la version des données hachées dans le cache distant, avec le suffixe :hash ajouté à la clé normale. Lorsque le cache local est obsolète, les données sont extraites de l'ordinateur distant via un adaptateur de cache.

Deux implémentations du cache L2 sont disponibles :

Mise en œuvre

Version

Description

Hérité (RemoteSynchronizedCache)

2.4.x

Cache à deux niveaux basé sur Zend avec Cm_Cache_Backend_File pour le stockage local

Moderne (symfony_l2)

2.4.9+

L2 basé sur Symfony Cache avec conformité PSR-6 et performances améliorées

INFO

Pour Adobe Commerce sur les infrastructures cloud, vous pouvez utiliser des variables de déploiement pour la configuration du cache L2.

Configuration de cache L2 héritée (RemoteSynchronizedCache)

Utilisez l’exemple suivant pour modifier ou remplacer la section de cache existante dans le fichier app/etc/env.php.

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => '\\Magento\\Framework\\Cache\\Backend\\RemoteSynchronizedCache',
            'backend_options' => [
                'remote_backend' => '\\Magento\\Framework\\Cache\\Backend\\Redis',
                'remote_backend_options' => [
                    'persistent' => 0,
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'password' => '',
                    'compress_data' => '1',
                ],
                'local_backend' => 'Cm_Cache_Backend_File',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/'
                ]
            ],
            'frontend_options' => [
                'write_control' => false,
            ],
        ]
    ],
    'type' => [
        'default' => ['frontend' => 'default'],
    ],
],

Où :

backend est l’implémentation du cache L2.
backend_options est la configuration du cache L2.
- remote_backend est l’implémentation du cache distant : Redis ou MySQL.
- remote_backend_options est la configuration du cache distant.
- local_backend mise en œuvre du cache local : Cm_Cache_Backend_File
- local_backend_options est la configuration du cache local.
- cache_dir est une option spécifique au cache de fichiers pour le répertoire dans lequel le cache local est stocké.

Adobe recommande d’utiliser Redis pour la mise en cache à distance (\Magento\Framework\Cache\Backend\Redis) et Cm_Cache_Backend_File pour la mise en cache locale des données en mémoire partagée, en utilisant : 'local_backend_options' => ['cache_dir' => '/dev/shm/']

Adobe recommande l’utilisation de la fonction cache preload, car elle réduit considérablement la pression sur Redis. N'oubliez pas d'ajouter le suffixe ':hash' pour les clés de préchargement.

Options de cache obsolètes

À partir de Commerce 2.4, l’option use_stale_cache peut améliorer les performances dans des cas spécifiques en diffusant des données précédemment mises en cache pendant que de nouvelles données de mise en cache sont générées dans un processus parallèle.

En règle générale, le compromis avec l’attente du verrou est acceptable du point de vue du rendement. Cependant, à mesure que le nombre de blocs ou d’entrées de cache augmente, les attentes de verrouillage prennent plus de temps. Dans certains scénarios, l’attente peut atteindre le nombre de clés x délai de recherche pour le processus. Dans de rares cas, un commerçant peut avoir des centaines de clés dans le cache Block/Config, de sorte que même un petit délai de recherche pour un verrou peut coûter des secondes.

IMPORTANT

Le cache obsolète ne fonctionne qu’avec le cache L2. Pour l’activer, ajoutez 'use_stale_cache' => true à la configuration de niveau supérieur du cache L2 frontal.

Adobe recommande de n’activer l’option use_stale_cache que pour les types de cache qui en bénéficient le plus, notamment :

block_html
config_integration_api
config_integration
full_page
layout
reflection
translate

Adobe déconseille d'activer l'option use_stale_cache pour le type de cache default.

Le code suivant illustre un exemple de configuration :

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => '\\Magento\\Framework\\Cache\\Backend\\RemoteSynchronizedCache',
            'backend_options' => [
                'remote_backend' => '\\Magento\\Framework\\Cache\\Backend\\Redis',
                'remote_backend_options' => [
                    'persistent' => 0,
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'password' => '',
                    'compress_data' => '1',
                ],
                'local_backend' => 'Cm_Cache_Backend_File',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/'
                ]
            ],
            'frontend_options' => [
                'write_control' => false,
            ],
        ],
         'stale_cache_enabled' => [
            'backend' => '\\Magento\\Framework\\Cache\\Backend\\RemoteSynchronizedCache',
            'backend_options' => [
                'remote_backend' => '\\Magento\\Framework\\Cache\\Backend\\Redis',
                'remote_backend_options' => [
                    'persistent' => 0,
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'password' => '',
                    'compress_data' => '1',
                ],
                'local_backend' => 'Cm_Cache_Backend_File',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/'
                ],
                'use_stale_cache' => true,
            ],
            'frontend_options' => [
                'write_control' => false,
            ],
        ]
    ],
    'type' => [
        'default' => ['frontend' => 'default'],
        'layout' => ['frontend' => 'stale_cache_enabled'],
        'block_html' => ['frontend' => 'stale_cache_enabled'],
        'reflection' => ['frontend' => 'stale_cache_enabled'],
        'config_integration' => ['frontend' => 'stale_cache_enabled'],
        'config_integration_api' => ['frontend' => 'stale_cache_enabled'],
        'full_page' => ['frontend' => 'stale_cache_enabled'],
        'translate' => ['frontend' => 'stale_cache_enabled']
    ],
],

Implémentation du cache moderne Symfony L2

[2.4.9-beta]{class="badge negative" title="Disponible uniquement dans la version 2.4.9-bêta."}

À partir de la version 2.4.9 de Commerce, vous pouvez utiliser l’implémentation du cache L2 basée sur le cache Symfony (serveur principal de symfony_l2) qui fournit une implémentation de mise en cache moderne et conforme à la norme PSR-6, avec des améliorations significatives des performances par rapport aux RemoteSynchronizedCache traditionnels.

Avantages du cache Symfony L2

Architecture moderne : repose sur les composants de cache Symfony (compatible avec PSR-6)
Meilleures performances : prise en charge native de la sérialisation Igbinary, de la compression gzip et des scripts Lua
Connexions persistantes : réduit la surcharge de connexion Redis ou Valkey avec le pool de connexions
Clés de préchargement : prend en charge le préchargement des clés de cache pour les données critiques
Prise en charge du cache obsolète : compatibilité totale avec l’option use_stale_cache
Configuration simplifiée : noms des types de serveur principal plus propres (redis, valkey, file)

Exemple de configuration avec le cache Symfony L2

Utilisez le type de serveur principal symfony_l2 simplifié pour le cache L2 :

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'symfony_l2',
            'backend_options' => [
                // L2 (Remote): Redis with Symfony Cache
                'remote_backend' => 'redis',
                'remote_backend_options' => [
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'password' => '',
                    'serializer' => 'igbinary',
                    'compression_lib' => 'gzip',
                    'persistent_id' => 'magento_l2_default',
                    'timeout' => '2.5',
                    'read_timeout' => '2.0',
                    'use_lua' => '1',
                    'preload_keys' => [
                        'prefix_EAV_ENTITY_TYPES:hash',
                        'prefix_GLOBAL_PLUGIN_LIST:hash',
                        'prefix_DB_IS_UP_TO_DATE:hash',
                        'prefix_SYSTEM_DEFAULT:hash',
                    ],
                ],
                // L1 (Local): File cache
                'local_backend' => 'file',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/magento_l1'
                ],
                'cleanup_percentage' => 90,
            ],
        ]
    ],
    'type' => [
        'default' => ['frontend' => 'default'],
    ],
],

Cache Symfony L2 avec cache périmé

Configurez des fronts distincts pour la prise en charge du cache obsolète :

'cache' => [
    'frontend' => [
        // Default frontend: NO stale cache
        'default' => [
            'backend' => 'symfony_l2',
            'backend_options' => [
                'remote_backend' => 'redis',
                'remote_backend_options' => [
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'serializer' => 'igbinary',
                    'compression_lib' => 'gzip',
                    'persistent_id' => 'magento_l2_default',
                ],
                'local_backend' => 'file',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/magento_l1'
                ],
            ],
        ],
        // Stale cache enabled frontend
        'stale_cache_enabled' => [
            'backend' => 'symfony_l2',
            'backend_options' => [
                'remote_backend' => 'redis',
                'remote_backend_options' => [
                    'server' => 'localhost',
                    'database' => '0',
                    'port' => '6379',
                    'serializer' => 'igbinary',
                    'compression_lib' => 'gzip',
                    'persistent_id' => 'magento_l2_stale',
                ],
                'local_backend' => 'file',
                'local_backend_options' => [
                    'cache_dir' => '/dev/shm/magento_l1_stale'
                ],
                'use_stale_cache' => true,
            ],
        ]
    ],
    'type' => [
        'default' => ['frontend' => 'default'],
        'layout' => ['frontend' => 'stale_cache_enabled'],
        'block_html' => ['frontend' => 'stale_cache_enabled'],
        'reflection' => ['frontend' => 'stale_cache_enabled'],
        'config_integration' => ['frontend' => 'stale_cache_enabled'],
        'config_integration_api' => ['frontend' => 'stale_cache_enabled'],
        'full_page' => ['frontend' => 'stale_cache_enabled'],
        'translate' => ['frontend' => 'stale_cache_enabled'],
    ],
],

Options principales du cache Symfony L2

Option

Type

Par défaut

Description

remote_backend

chaîne

'redis'

Type de serveur principal distant : redis, valkey ou file

remote_backend_options

tableau

[]

Configuration du serveur principal distant (voir la documentation de Redis/Valkey)

local_backend

chaîne

'file'

Type de serveur principal local : file ou apcu

local_backend_options

tableau

[]

Configuration du serveur principal local

cleanup_percentage

nombre entier

90

Seuil de nettoyage du cache L1 (1-100)

use_stale_cache

booléen

false

Activer le cache obsolète pour une haute disponibilité

Prise en charge de Valkey

Le serveur principal symfony_l2 prend également en charge Valkey en tant que serveur principal distant :

'backend_options' => [
    'remote_backend' => 'valkey',  // Use Valkey instead of Redis
    'remote_backend_options' => [
        'server' => 'localhost',
        'database' => '0',
        'port' => '6379',
        'serializer' => 'igbinary',
        'compression_lib' => 'gzip',
    ],
    // ... rest of configuration
]

Pour obtenir des options de configuration détaillées, voir :

recommendation-more-help

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