Mettre en cache les options principales et la référence de stockage
app/etc/env.php locale.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.
Options de cache du serveur principal
Le tableau suivant résume les caches principaux disponibles :
var/cache/. Aucune configuration requise.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
Les exemples PHP suivants configurent le serveur principal du cache dans <Commerce-install-dir>/app/etc/env.php. Ils n’activent pas la mise en cache L2.
Magento\Framework\Cache\Backend\RedisMagento\Framework\Cache\Backend\ValkeyfilevalkeyPour obtenir une prise en charge exacte des correctifs, consultez la Configuration requise.
redis, mais Redis n’est pas un service de cache officiellement pris en charge où Valkey est requis. Utilisez valkey à la place.Exemples de serveur principal basés sur Zend hérités
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.
Utilisez le nom de classe Redis complet uniquement sur les versions où Redis est pris en charge :
| code language-php?start_inline=1 |
|---|
|
Utilisez le nom de classe Valkey complet sur les versions qui prennent en charge l’ancien serveur principal Valkey :
| code language-php?start_inline=1 |
|---|
|
Serveur principal du cache Symphony moderne
Le serveur principal direct par défaut est le système de fichiers. Pour utiliser Valkey avec l’implémentation moderne, utilisez le type de serveur principal valkey simplifié.
L’exemple de configuration suivant est correct pour Adobe Commerce 2.4.9 et les versions ultérieures, ainsi que pour les rétroports pris en charge où Valkey est pris en charge, lors de la configuration de la mise en cache directe par défaut avec l’implémentation moderne de Symfony Cache.
'cache' => [
'frontend' => [
'default' => [
'backend' => 'valkey',
'backend_options' => [
'server' => '127.0.0.1',
'database' => '0',
'port' => '6379',
],
],
],
],
Implémentations du 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 la configuration locale, voir Configuration du cache L2 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.
Configuration du cache L2
-
Pour Adobe Commerce on-premises d’informations sur la configuration, voir Configuration du cache L2.
-
Par Adobe Commerce on Cloud, configurez la mise en cache L2 par le biais de la variable de déploiement appropriée plutôt que de modifier
app/etc/env.phpdirectement. Voir Déployer les variables dans la documentation Adobe Commerce sur le cloud.