[En las instalaciones]{class="badge informative" title="Solo se aplica a los proyectos locales de Adobe Commerce."}

Opciones del servidor de caché y referencia de almacenamiento

NOTE
Esta página documenta la configuración de app/etc/env.php local.
Para Adobe Commerce on Cloud proyectos, el paquete ece-tools genera la configuración app/etc/env.php resultante durante la implementación en función de la configuración de la variable de implementación en .magento.env.yaml. No edita el archivo env.php. Vea las Prácticas recomendadas para la configuración de los servicios Valkey y Redis y Implementar variables.

La aplicación de Commerce utiliza un front-end y un back-end de caché de bajo nivel para proporcionar acceso al almacenamiento en caché. Commerce admite varios back-ends y estrategias de almacenamiento en caché, cada uno adaptado a diferentes casos de uso. Esta página describe los backends disponibles y cómo difieren.

NOTE
Varnish administra el almacenamiento en caché de página completa en el nivel HTTP para implementaciones locales. El servicio Fastly lo administra para implementaciones de nube. Ninguna de las dos soluciones utiliza el backend de caché de nivel bajo.

Opciones de caché back-end

La siguiente tabla resume las cachés backend disponibles:

Servidor
Descripción
Guía de configuración
Sistema de archivos
Predeterminado. Almacena datos de caché en archivos bajo var/cache/. No se requiere configuración.
N/D
Redis
Almacén de datos en memoria para el almacenamiento en caché de alto rendimiento.
Usar Redis para la caché predeterminada
Valkey
Alternativa de código abierto y compatible con Redis.
Usar Valkey para la caché predeterminada
Base de datos
Motor de caché personalizado respaldado por una base de datos
Crear motores de caché personalizados (documentación de Adobe Developer)
IMPORTANT
La caché de Redis no es compatible con Adobe Commerce 2.4.9 o con versiones de parches posteriores a las 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 y 2.4.8-p4. Si va a actualizar a una de estas versiones, configure Valkey y actualice la configuración de la caché para utilizarlo. Para Adobe Commerce on-premises, consulte configurar Valkey.

Implementaciones back-end de caché y L2 implementation-approaches

Commerce admite back-ends de caché directo y almacenamiento en caché L2. Un servidor directo selecciona el almacenamiento en caché. El almacenamiento en caché L2 agrega una capa de caché local delante del almacenamiento remoto.

Backends de caché directo

Los siguientes ejemplos de PHP configuran el servidor de caché en <Commerce-install-dir>/app/etc/env.php. No habilitan el almacenamiento en caché L2.

Versión de Commerce
Implementación
Servidor
Valor de configuración
2.4.8 y versiones anteriores, si son compatibles
Heredado
Sistema de archivos (predeterminado)
No se requiere configuración
2.4.8 y versiones anteriores, si son compatibles
Heredado
Redis
Magento\Framework\Cache\Backend\Redis
2.4.8 y versiones anteriores, si son compatibles
Heredado
Valkey
Magento\Framework\Cache\Backend\Valkey
2.4.9 y versiones posteriores, además de puertos posteriores compatibles
Caché Symfony moderna
Sistema de archivos (predeterminado)
file
2.4.9 y versiones posteriores, además de puertos posteriores compatibles
Caché Symfony moderna
Valkey
valkey

Para obtener una compatibilidad exacta a nivel de parche, consulte Requisitos del sistema.

NOTE
La implementación moderna acepta el nombre de tipo redis, pero Redis no es un servicio de caché admitido oficialmente donde se requiere Valkey. Utilice valkey en su lugar.

Ejemplos de back-end basados en Zend heredados

En implementaciones locales, los siguientes ejemplos configuran los backends de caché directo en <Commerce-install-dir>/app/etc/env.php. No habilitan el almacenamiento en caché L2. No utilice estos ejemplos para implementaciones de Adobe Commerce on Cloud, que utilizan el paquete ece-tools para generar la configuración de app/etc/env.php resultante durante la implementación.

Redis de back-end heredado

Utilice el nombre de clase completo de Redis solo en versiones donde se admita Redis:

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 de back-end heredado

Utilice el nombre completo de la clase Valkey en las versiones compatibles con el back-end heredado de Valkey:

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

Modern Symfony Cache backend

El backend directo predeterminado es el sistema de archivos. Para usar Valkey con la implementación moderna, use el tipo de backend valkey simplificado.

El siguiente ejemplo de configuración es correcto para Adobe Commerce 2.4.9 y versiones posteriores, y puertos posteriores compatibles donde se admite Valkey, al configurar el almacenamiento en caché predeterminado directo con la implementación moderna de Symfony Cache.

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'valkey',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379',
            ],
        ],
    ],
],
TIP
La implementación de Symfony Cache admite características de rendimiento opcionales como serialización binaria, compresión, secuencias de comandos Lua y conexiones persistentes. Para obtener más información, consulte Configurar Valkey para el valor predeterminado y la memoria caché de la página.

Implementaciones de caché L2

El almacenamiento en caché L2 (de dos niveles) agrega una capa de caché local en cada nodo web delante del almacenamiento de caché remoto compartido, lo que reduce el tráfico de red entre Commerce y la caché remota.

Versión de Commerce
Implementación de L2
Back-end remoto
Antes de 2.4.9, donde es compatible
RemoteSynchronizedCache
Redis o Valkey, según la versión de Commerce y la matriz de compatibilidad a nivel de parche
2.4.9 y posterior
symfony_l2
Valkey

Para la configuración local, consulte Configuración de caché L2.

Para proyectos en la nube, configure el almacenamiento en caché L2 mediante las variables de implementación descritas en Implementar variables.

Configuración de caché L2

  • Para obtener detalles de configuración de Adobe Commerce on-premises, consulte Configuración de caché L2.

  • Para Adobe Commerce on Cloud, configure el almacenamiento en caché L2 a través de la variable de implementación apropiada en lugar de editar app/etc/env.php directamente. Consulte Implementar variables en la documentación de Adobe Commerce en la nube.

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