DocumentationCommerceGuide de configuration

[Sur Site]{class="badge informative" title="S’applique uniquement aux projets sur site Adobe Commerce."}

Mettre en cache les options principales et la référence de stockage

Dernière mise à jour : 16 septembre 2026

Créé pour :

  • Intermédiaire
  • Administrateur ou administratrice
  • Développeur
NOTE
Cette page documente la configuration app/etc/env.php locale.
Pour les projets Adobe Commerce on Cloud, le package de ece-tools génère la configuration de app/etc/env.php résultante pendant le déploiement en fonction de la configuration de la variable de déploiement dans .magento.env.yaml. Vous ne modifiez pas le fichier env.php. Voir Bonnes pratiques pour la configuration des services Valkey et Redis et Déployer des variables.

L’application Commerce utilise un cache de bas niveau frontal et principal pour permettre l’accès au stockage du cache. Commerce prend en charge plusieurs stratégies et back-ends de mise en cache, chacun adapté à différents cas d’utilisation. Cette page décrit les serveurs principaux disponibles et leurs différences.

NOTE
Vernis gère la mise en cache complète des pages au niveau HTTP pour les déploiements sur site. Le service Fastly s’en charge pour les déploiements dans le cloud. Aucune solution n’utilise le serveur principal de cache de bas niveau.

Options de cache du serveur principal

Le tableau suivant résume les caches principaux disponibles :

Serveur principal
Description
Guide de configuration
Système de fichiers
Valeur par défaut. Stocke les données de cache dans des fichiers sous var/cache/. Aucune configuration requise.
S.O.
Redis
Magasin de données en mémoire pour une mise en cache hautes performances.
Utiliser Redis pour le cache par défaut
Valkey
Alternative open source compatible avec Redis.
Utiliser Valkey pour le cache par défaut
Base de données
Moteur de cache personnalisé soutenu par une base de données
Création de moteurs de cache personnalisés (documentation Adobe Developer)
IMPORTANT
Le cache Redis n’est pas pris en charge pour Adobe Commerce 2.4.9 ou pour les versions de correctif ultérieures à 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 et 2.4.8-p4. Si vous effectuez une mise à niveau vers l’une de ces versions, configurez Valkey et mettez à jour la configuration du cache pour l’utiliser. Pour Adobe Commerce on-premises d’informations, voir ​ Configuration de Valkey ​.

Implémentations principales et L2 du cache implementation-approaches

Commerce prend en charge les serveurs principaux de cache direct et la mise en cache L2. Un serveur principal direct sélectionne le stockage en cache. La mise en cache L2 ajoute une couche de cache locale devant le stockage distant.

Serveurs principaux de cache direct

Le tableau suivant résume les valeurs de configuration du serveur principal du cache pour <Commerce-install-dir>/app/etc/env.php. Il n’active pas la mise en cache L2.

Version de Commerce
Serveur principal
Valeur de configuration
2.4.8 et versions antérieures, si pris en charge
fichier
Valeur par défaut. Aucune configuration requise
2.4.8 et versions antérieures, si pris en charge
Redis
Magento\Framework\Cache\Backend\Redis
2.4.8 et versions antérieures, si pris en charge
Valkey
Magento\Framework\Cache\Backend\Valkey
2.4.9 et versions ultérieures, et rétroportages pris en charge
fichier
file
2.4.9 et versions ultérieures, et rétroportages pris en charge
Valkey
valkey

Pour obtenir une prise en charge exacte des correctifs, consultez la Configuration requise.

[!TAB Cache basé sur Zend (2.4.8 et versions antérieures)]

Exemples de serveur principal

Pour les déploiements sur site, les exemples suivants configurent les serveurs principaux de cache direct dans <Commerce-install-dir>/app/etc/env.php. Ils n’activent pas la mise en cache L2. N’utilisez pas ces exemples pour les déploiements Adobe Commerce on Cloud, qui utilisent le package ece-tools pour générer la configuration de app/etc/env.php résultante pendant le déploiement.

Redis

Utilisez le nom de classe Redis complet uniquement sur les versions où Redis est pris en charge :

code language-php?start_inline=1 
'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379',
            ],
        ],
    ],
],
Valkey
code language-php?start_inline=1 
'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'valkey',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379',
            ],
        ],
    ],
],

Mise en cache L2

La mise en cache L2 (à deux niveaux) ajoute une couche de cache locale sur chaque nœud web devant le stockage de cache distant partagé, réduisant ainsi le trafic réseau entre Commerce et le cache distant. Pour connaître les options d’implémentation, la prise en charge des versions et les étapes de configuration, consultez Configuration du cache L2.

Pour les projets cloud, configurez la mise en cache L2 par le biais des variables de déploiement décrites dans Déployer les variables.

recommendation-more-help
commerce-operations-help-configuration