Gerenciar o cache

WARNING
Todos os comandos CLI do Magento devem ser executados pelo proprietário do sistema de arquivos.

Tipos de cache

Você pode usar o sistema de gerenciamento de cache do Adobe Commerce para melhorar o desempenho do site. Este tópico explica como os administradores de sistema ou desenvolvedores com acesso ao servidor de aplicativos do Commerce podem gerenciar caches na linha de comando.

NOTE
Os administradores de site de comércio podem gerenciar o cache do Administrador usando a ferramenta Sistema de gerenciamento de cache. Consulte Gerenciamento de Cache no Guia de Sistemas de Administração.

Exibir o status do cache

Na linha de comando do servidor de aplicativos Commerce, exiba o status do cache usando o comando da CLI do Commerce cache:status.

   bin/magento cache:status

A seguir, há uma amostra:

Current status:
                        config: 1
                        layout: 1
                    block_html: 1
                   collections: 1
                    reflection: 1
                        db_ddl: 1
               compiled_config: 1
             webhooks_response: 1
                           eav: 1
         customer_notification: 1
 graphql_query_resolver_result: 1
            config_integration: 1
        config_integration_api: 1
                  admin_ui_sdk: 1
                     full_page: 1
                   target_rule: 1
             config_webservice: 1
                     translate: 1
TIP
Para obter uma descrição detalhada dos tipos de cache padrão com suporte do Adobe Commerce, consulte Caches no Guia de Sistemas de Administração.

Habilitar ou desabilitar tipos de cache

Esse comando permite habilitar ou desabilitar todos os tipos de cache ou apenas os que você especificar. A desativação dos tipos de cache é útil durante o desenvolvimento, pois você vê os resultados de suas alterações sem ter que liberar o cache; no entanto, a desativação dos tipos de cache tem um efeito adverso no desempenho.

INFO
A partir da versão 2.2, você só pode ativar ou desativar tipos de cache usando a linha de comando ao executar o Commerce no modo de produção. Se estiver executando o Commerce no modo de desenvolvedor, você poderá ativar ou desativar os tipos de cache usando a linha de comando ou manualmente. Antes de fazer isso, você deve tornar o <magento_root>/app/etc/env.php gravável manualmente pelo proprietário do sistema de arquivos.

Você pode limpar (também conhecido como liberar ou atualizar) tipos de cache usando a linha de comando ou o Administrador.

Opções de comando:

bin/magento cache:enable [type] ... [type]
bin/magento cache:disable [type] ... [type]

Quando a omissão de [type] habilita ou desabilita todos os tipos de cache ao mesmo tempo. A opção type é uma lista separada por espaços de tipos de cache.

Para listar os tipos de cache e seus status:

bin/magento cache:status

Por exemplo, para desativar o cache de página inteira e o cache DDL:

bin/magento cache:disable db_ddl full_page

Exemplo de resultado:

   Changed cache status:
       db_ddl: 1 -> 0
    full_page: 1 -> 0
INFO
Habilitar um tipo de cache limpa automaticamente esse tipo de cache.
INFO
A partir da versão 2.3.4, o Commerce armazena em cache todos os atributos de EAV do sistema conforme são recuperados. O armazenamento em cache de atributos de EAV dessa maneira melhora o desempenho, pois diminui a quantidade de solicitações de inserção/seleção para o BD. No entanto, também aumenta o tamanho da rede de cache. Os desenvolvedores podem armazenar em cache atributos personalizados de EAV executando o comando bin/magento config:set dev/caching/cache_user_defined_attributes 1. Isso também pode ser feito pelo Administrador no Modo de desenvolvedor definindo Lojas > Configurações Configuração > Avançado > Desenvolvedor > Configurações de cache > Atributos de Cache Definidos pelo Usuário para Sim.

Limpar e liberar tipos de cache

NOTE
O cache de várias páginas pode ser invalidado simultânea e automaticamente sem a edição dessas entidades. Por exemplo, quando qualquer produto no catálogo é atribuído a qualquer categoria ou quando qualquer related product rule é modificado.

Para limpar itens desatualizados do cache, você pode limpar ou liberar tipos de cache:

  • A limpeza de um tipo de cache exclui todos os itens apenas dos tipos de cache do Commerce ativados. Em outras palavras, essa opção não afeta outros processos ou aplicativos porque ela limpa somente o cache que o Commerce usa.

    Os tipos de cache desativados não são limpos.

    note tip
    TIP
    Sempre limpe o cache após atualizar as versões do Adobe Commerce, atualizar do Magento Open Source para o Adobe Commerce ou instalar B2B para o Adobe Commerce ou qualquer módulo.
  • A limpeza de um tipo de cache limpa o armazenamento em cache, o que pode afetar outros aplicativos de processos que estejam usando o mesmo armazenamento.

Limpe os tipos de cache se você já tiver tentado limpar o cache e ainda tiver problemas que não podem ser isolados.

Uso do comando:

   bin/magento cache:clean [type] ... [type]
   bin/magento cache:flush [type] ... [type]

Onde [type] é uma lista separada por espaços de tipos de cache. Omitindo [type], limpa ou libera todos os tipos de cache ao mesmo tempo. Por exemplo, para liberar todos os tipos de cache, informe

   bin/magento cache:flush

Exemplo de resultado:

   Flushed cache types:
   config
   layout
   block_html
   collections
   reflection
   db_ddl
   compiled_config
   eav
   customer_notification
   config_integration
   config_integration_api
   full_page
   graphql_query_resolver_results
   config_webservice
   translate
TIP
Também é possível limpar e liberar tipos de cache no Administrador. Vá para Sistema > Ferramentas > Gerenciamento de Cache. Liberar Armazenamento de Cache é equivalente a bin/magento cache:flush. Liberar Cache de Magento é equivalente a bin/magento cache:clean.
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c