DocumentaçãoCommerceGuia de configuração

[No local]{class="badge informative" title="Aplicável somente a projetos locais do Adobe Commerce."}

Opções de back-end de cache e referência de armazenamento

Última atualização: 20 de agosto de 2026

Criado para:

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"}
  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}
NOTE
Esta página documenta a configuração app/etc/env.php local.
Para projetos Adobe Commerce on Cloud, o pacote ece-tools gera a configuração app/etc/env.php resultante durante a implantação com base na configuração da variável de implantação em .magento.env.yaml. Você não edita o arquivo env.php. Consulte Práticas recomendadas para a configuração do serviço Valkey e Redis e Implantar variáveis.

O aplicativo Commerce usa um front-end e back-end de cache de baixo nível para fornecer acesso ao armazenamento em cache. O Commerce oferece suporte a vários back-end e estratégias de armazenamento em cache, cada um adequado a casos de uso diferentes. Esta página descreve as infraestruturas disponíveis e a sua diferença.

NOTE
Verniz lida com o armazenamento em cache de página inteira no nível HTTP para implantações locais. O Fastly service o manipula para implantações na Nuvem. Nenhuma das soluções usa o back-end do cache de baixo nível.

Opções de cache de back-end

A tabela a seguir resume os caches de backend disponíveis:

Infraestrutura
Descrição
Guia de configuração
Sistema de arquivos
Padrão. Armazena dados do cache em arquivos em var/cache/. Nenhuma configuração é necessária.
N/D
Redis
Armazenamento de dados na memória para cache de alto desempenho.
Usar Redis para cache padrão
Valkey
Alternativa de código aberto e compatível com Redis.
Usar Valkey para cache padrão
Banco de dados
Mecanismo de cache personalizado apoiado por um banco de dados
Criar mecanismos de cache personalizados (documentação do Adobe Developer)
IMPORTANT
O cache Redis não é suportado para o Adobe Commerce 2.4.9 ou versões de patch posteriores a 2.4.5-p16, 2.4.6-p14, 2.4.7-p9 e 2.4.8-p4. Se você estiver atualizando para uma dessas versões, configure Valkey e atualize a configuração do cache para usá-la. Para Adobe Commerce on-premises, consulte configurar Valkey.

Implementações de back-end de cache e L2 implementation-approaches

O Commerce oferece suporte a back-end de cache direto e cache L2. Um back-end direto seleciona o armazenamento em cache. O cache L2 adiciona uma camada de cache local na frente do armazenamento remoto.

Infraestruturas de cache diretas

Os exemplos de PHP a seguir configuram o back-end do cache em <Commerce-install-dir>/app/etc/env.php. Eles não ativam o cache L2.

Versão do Commerce
Implementação
Infraestrutura
Valor de configuração
2.4.8 e anterior, quando suportado
Herdados
Sistema de arquivos (padrão)
Nenhuma configuração é necessária
2.4.8 e anterior, quando suportado
Herdados
Redis
Magento\Framework\Cache\Backend\Redis
2.4.8 e anterior, quando suportado
Herdados
Valkey
Magento\Framework\Cache\Backend\Valkey
2.4.9 e posteriores, além de portas de apoio compatíveis
Modern Symfony Cache
Sistema de arquivos (padrão)
file
2.4.9 e posteriores, além de portas de apoio compatíveis
Modern Symfony Cache
Valkey
valkey

Para obter suporte exato em nível de patch, consulte os Requisitos do sistema.

NOTE
A implementação moderna aceita o nome de tipo redis, mas Redis não é um serviço de cache oficialmente suportado, onde Valkey é necessário. Em vez disso, use valkey.

Exemplos de back-end herdados baseados em Zend

Para implantações locais, os exemplos a seguir configuram back-ends de cache direto em <Commerce-install-dir>/app/etc/env.php. Eles não ativam o cache L2. Não use estes exemplos para Adobe Commerce on Cloud implantações, que usam o pacote ece-tools para gerar a configuração app/etc/env.php resultante durante a implantação.

Redis de back-end herdado

Use o nome completo da classe Redis apenas em versões em que o Redis é compatível:

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 herdado

Use o nome completo da classe Valkey em versões que oferecem suporte ao back-end Valkey herdado:

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',
            ],
        ],
    ],
],

Infraestrutura do Modern Symfony Cache

O back-end direto padrão é o sistema de arquivos. Para usar o Valkey com a implementação moderna, use o tipo de back-end simplificado valkey.

O exemplo de configuração a seguir está correto para o Adobe Commerce 2.4.9 e posterior, e backports compatíveis, onde o Valkey é compatível, ao configurar o armazenamento em cache padrão direto com a implementação moderna do Symfony Cache.

'cache' => [
    'frontend' => [
        'default' => [
            'backend' => 'valkey',
            'backend_options' => [
                'server' => '127.0.0.1',
                'database' => '0',
                'port' => '6379',
            ],
        ],
    ],
],
TIP
A implementação do Symfony Cache suporta recursos opcionais de desempenho, como serialização igbinary, compressão, scripts Lua e conexões persistentes. Para obter detalhes, consulte Configurar Valkey para Padrão e Cache de Página.

Implementações de cache L2

O cache L2 (de dois níveis) adiciona uma camada de cache local em cada nó da Web em frente ao armazenamento de cache remoto compartilhado, reduzindo o tráfego de rede entre o Commerce e o cache remoto.

Versão do Commerce
Implementação do L2
Infraestrutura remota
Antes do 2.4.9, quando suportado
RemoteSynchronizedCache
Redis ou Valkey, dependendo da versão do Commerce e da matriz de suporte de nível de patch
2.4.9 e posterior
symfony_l2
Valkey

Para configuração local, consulte configuração do cache L2.

Para projetos na nuvem, configure o cache L2 por meio das variáveis de implantação descritas em Implantar variáveis.

Configuração do cache L2

  • Para obter detalhes sobre a configuração de Adobe Commerce on-premises, consulte configuração do cache L2.

  • Para Adobe Commerce on Cloud, configure o cache L2 por meio da variável de implantação apropriada, em vez de editar app/etc/env.php diretamente. Consulte Implantar variáveis na documentação do Adobe Commerce na nuvem.

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