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: 16 de setembro de 2026

Criado para:

  • Intermediário
  • Admin
  • Desenvolvedor
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

A tabela a seguir resume os valores de configuração de back-end do cache para <Commerce-install-dir>/app/etc/env.php. Ele não ativa o cache L2.

Versão do Commerce
Infraestrutura
Valor de configuração
2.4.8 e anterior, quando suportado
arquivo
Padrão. Nenhuma configuração é necessária
2.4.8 e anterior, quando suportado
Redis
Magento\Framework\Cache\Backend\Redis
2.4.8 e anterior, quando suportado
Valkey
Magento\Framework\Cache\Backend\Valkey
2.4.9 e posteriores, além de portas de apoio compatíveis
arquivo
file
2.4.9 e posteriores, além de portas de apoio compatíveis
Valkey
valkey

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

[!TAB Cache baseado no Zend (2.4.8 e anterior)]

Exemplos de backend

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

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

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. Para opções de implementação, suporte de versão e etapas de configuração, 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.

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