Documentação Commerce Guia de configuração

Configurar front-ends do cache

Última atualização: 19 de maio de 2026

Tópicos:
Configuration
Cache

Criado para:

Experienced
Admin
Developer

Um front-end de cache é uma interface entre o Commerce e o back-end de armazenamento em cache. Você pode definir vários front-ends, cada um com configurações de back-end diferentes, e atribuir tipos de cache específicos a cada front-end.

Isso é útil quando você deseja usar diferentes back-ends de cache ou configurações para diferentes tipos de dados em cache. Por exemplo, você pode querer o cache de full_page em um banco de dados Redis dedicado ao usar um banco de dados separado para o cache de default.

Usar o front-end padrão

O Commerce fornece um front-end de cache do default que funciona para todos os tipos de cache. Ele estende o Zend_Cache_Core implementando o cache de front-end Magento\Framework\Cache\Core.

Na maioria dos casos, não é necessário personalizar o front-end. Você só precisa configurar o back-end. Consulte Opções de back-end do cache.

Definir um front-end do cache personalizado

As etapas a seguir passam pela associação de um front-end de cache com um tipo de cache.

Etapa 1: definir um front-end do cache e atribuir tipos de cache

Para definir um front-end de cache personalizado, adicione a configuração a app/etc/env.php (que substitui di.xml):

'cache' => [
    'frontend' => [
        '<unique frontend id>' => [
             <cache options>
        ],
    ],
    'type' => [
         <cache type 1> => [
             'frontend' => '<unique frontend id>'
        ],
         <cache type 2> => [
             'frontend' => '<unique frontend id>'
        ],
    ],
],

Onde:

<unique frontend id> — Um nome exclusivo para identificar o front-end (por exemplo, default, page_cache, stale_cache_enabled)
<cache options> — Tipo de back-end e opções para este front-end (consulte Opções de cache)
<cache type> — Um tipo de cache do Commerce a ser atribuído a este front-end (por exemplo, config, layout, block_html, full_page)

TIP

Implementação do Modern Symfony Cache (2.4.9+): A partir do Commerce 2.4.9, você pode usar tipos de back-end simplificados como redis, valkey ou file com a implementação moderna do Symfony Cache. Consulte Usar Redis para cache padrão e Usar Valkey para cache padrão para obter detalhes.

Etapa 2: configurar opções de front-end e back-end

Você pode especificar opções de configuração de cache front-end e back-end em env.php ou di.xml. Esta tarefa é opcional. Se você não especificar opções, o Commerce usará as configurações padrão de front-end e back-end.

env.php exemplo:

'frontend' => <frontend_type>,
'frontend_options' => [
    <frontend_option> => <frontend_option_value>,
    ...
],
'backend' => <backend_type>,
'backend_options' => [
    <backend_option> => <backend_option_value>,
    ...
],

Onde:

<frontend_type> — O tipo de cache de front-end de baixo nível. Especifique um nome de classe compatível com Zend\Cache\Core.
Se omitido, Magento\Framework\Cache\Core será usado.
<frontend_option>, <frontend_option_value> — O nome e o valor das opções que a estrutura Commerce transmite como uma matriz associativa para o cache de front-end na criação.
<backend_type> — O tipo de cache de back-end de baixo nível. Você pode especificar:
- Modern Symfony Cache (2.4.9+, recomendado): nomes simplificados como redis, valkey ou file
- Herdado (baseado em Zend): nome de classe completo compatível com Zend_Cache_Backend que implementa Zend_Cache_Backend_Interface
<backend_option>, <backend_option_value> — O nome e o valor das opções que a estrutura Commerce passa como uma matriz associativa para o cache de back-end na criação.

NOTE

Implementação herdada vs. moderna:

Herdado (Zend-based): 'backend' => 'Magento\\Framework\\Cache\\Backend\\Redis'
Moderno (Symfony Cache): 'backend' => 'redis' (recomendado para o Commerce 2.4.9+)

A implementação moderna do Symfony Cache oferece melhor desempenho através da conformidade com PSR-6, serialização Igbinary, compactação gzip, scripts Lua e conexões persistentes.

Consulte a documentação do Laminas para opções baseadas em Zend ou os guias modernos do Symfony Cache para Redis e Valkey.

recommendation-more-help

commerce-operations-help-configuration