Documentación Commerce Guía de configuración

Configurar tipos y front-end de caché

Última actualización: 16 de septiembre de 2026

Temas:
Configuración

Creado para:

Intermedio
Administrador
Desarrollador

Un front-end de caché conecta los tipos de caché de Commerce con el almacenamiento de caché. Puede definir varios front-end y asignar tipos de caché específicos a cada front-end.

Utilice la siguiente relación para determinar dónde almacena sus datos un tipo de caché:

tipo de caché → caché front-end → back-end de caché

style

shade-box

Para obtener una descripción general de la arquitectura de almacenamiento en caché de Commerce, consulte Información general de almacenamiento en caché y opciones de configuración.

NOTE

Para Adobe Commerce en la infraestructura en la nube, use la configuración de implementación en la nube que se describe en la guía de Cloud. No edite app/etc/env.php directamente. Las herramientas de implementación generan este archivo y pueden sobrescribir los cambios manuales.

Usar el front-end predeterminado

Commerce proporciona un front-end predeterminado que pueden utilizar todos los tipos de caché.

En la mayoría de los casos, no es necesario definir un front-end personalizado. Si todos los tipos de caché pueden utilizar las mismas opciones de back-end y back-end, utilice el front-end predeterminado y configure su back-end. Consulte Opciones de servidor de caché para obtener la configuración específica de servidor.

Para las versiones de Adobe Commerce anteriores a la 2.4.9, el front-end predeterminado utiliza la implementación de caché basada en Zend heredada. El front-end Magento\Framework\Cache\Core extiende Zend_Cache_Core. Adobe Commerce 2.4.9 y versiones posteriores utilizan la implementación moderna de Symfony. Consulte Opciones de servidor de caché para obtener instrucciones específicas de la versión.

Definir un front-end personalizado

Utilice un front-end de caché personalizado cuando uno o más tipos de caché necesiten configuraciones de back-end que difieran de las del front-end predeterminado.

Para implementaciones locales, defina el front-end en app/etc/env.php. A continuación, asígnele uno o varios tipos de caché:

'cache' => [
    'frontend' => [
        '<frontend-id>' => [
            'backend' => '<backend-type>',
            'backend_options' => [
                // Backend-specific options
            ],
        ],
    ],
    'type' => [
        '<cache-type-id>' => [
            'frontend' => '<frontend-id>',
        ],
    ],
],

Donde:

<frontend-id> es el identificador único del front-end, como default o page_cache.
<backend-type> identifica el servidor usado por el front-end. El valor admitido depende de la versión de Adobe Commerce y del back-end seleccionado.
backend_options contiene opciones para el backend seleccionado.
<cache-type-id> es un tipo de caché de Commerce, como config, layout, block_html o full_page.

Para ver los tipos de servidor, las opciones compatibles y los ejemplos de configuración específicos de la versión, consulte Opciones de servidor de caché.

Asignar un tipo de caché a un front-end

La configuración de type asigna un tipo de caché a un front-end:

'type' => [
    'full_page' => [
        'frontend' => 'page_cache',
    ],
],

Donde:

<frontend_type>: el tipo de caché de nivel inferior de front-end. Especifique un nombre de clase compatible con Zend_Cache_Core.
Si se omite, se usa Magento\Framework\Cache\Core.
<frontend_option>, <frontend_option_value>: el nombre y valor de las opciones que el marco de trabajo de Commerce pasa como una matriz asociativa a la caché de front-end en el momento de la creación.
<backend_type>: el tipo de caché de servidor de nivel bajo. Puede especificar:
- Caché Symfony (2.4.9+, recomendado): Nombres simplificados como valkey o file
- Basado en Zend: Nombre de clase completo compatible con Zend_Cache_Backend que implementa Zend_Cache_Backend_Interface
<backend_option>, <backend_option_value>: nombre y valor de las opciones que el marco de trabajo de Commerce pasa como una matriz asociativa a la caché back-end al crearla.

NOTE

Para los formatos de valor de servidor, como los nombres de clase basados en Zend frente a los nombres simplificados de Symfony Cache como valkey o file, consulte Opciones de servidor de caché.

recommendation-more-help

commerce-operations-help-configuration