DocumentaciónCommerceGuía de configuración

[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

Última actualización: 16 de septiembre de 2026

Creado para:

  • Intermedio
  • Administrador
  • Desarrollador
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

La siguiente tabla resume los valores de configuración del servidor de caché para <Commerce-install-dir>/app/etc/env.php. No habilita el almacenamiento en caché L2.

Versión de Commerce
Servidor
Valor de configuración
2.4.8 y versiones anteriores, si son compatibles
archivo
Predeterminado. No se requiere configuración
2.4.8 y versiones anteriores, si son compatibles
Redis
Magento\Framework\Cache\Backend\Redis
2.4.8 y versiones anteriores, si son compatibles
Valkey
Magento\Framework\Cache\Backend\Valkey
2.4.9 y versiones posteriores, además de puertos posteriores compatibles
archivo
file
2.4.9 y versiones posteriores, además de puertos posteriores compatibles
Valkey
valkey

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

[!TAB Caché basada en Zend (2.4.8 y anteriores)]

Ejemplos de back-end

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

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
code language-php?start_inline=1 
'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'valkey',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379',
            ],
        ],
    ],
],

Almacenamiento en 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. Para obtener opciones de implementación, compatibilidad con versiones y pasos de configuración, 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.

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