Documentação

Desative a saída do banner do Adobe Commerce para melhorar o desempenho do site

Last update: Wed Apr 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Este artigo fornece uma resolução para baixo desempenho do site. Problemas de desempenho podem ocorrer quando o módulo Magento_Banner está habilitado, mas não está em uso. Desativar a saída do módulo pode melhorar o desempenho do site; no entanto, essa ação remove a funcionalidade Blocos dinâmicos do Administrador.

Descrição description

Ambiente

  • Adobe Commerce na infraestrutura em nuvem v.2.4.x
  • Adobe Commerce no local v.2.4.x

Problema/Sintomas

O módulo Magento_Banner está habilitado, mas não está em uso.

Para verificar se esse é o caso:

Para o Adobe Commerce na infraestrutura de nuvem 2.3.x e mais recente (a funcionalidade foi renomeada na v 2.3.x):

  1. Faça logon no Administrador do Commerce.
  2. Navegar até Conteúdo > Elementos > Blocos Dinâmicos.
  3. Se a grade exibida nessa página estiver vazia, significa que você não tem blocos dinâmicos (banners).

Se você não vir a opção Blocos dinâmicos em Conteúdo > Elementos, significa que você já aplicou a recomendação deste artigo. Para ver a opção de banners novamente, inverta o processo.

Causa raiz

Quando o módulo Magento_Banner está habilitado, o Adobe Commerce envia solicitações do Ajax da loja para o servidor para obter as informações do banner. Essas solicitações do Ajax têm um impacto no desempenho, especialmente em condições de alta carga (alto volume e alto tráfego). Se a funcionalidade não for usada, é recomendável desativar a saída do módulo. Não é recomendável desativar o módulo, devido a problemas de dependência.

Resolução resolution

Aviso: É altamente recomendável testar as alterações no Ambiente de preparo/integração primeiro, antes de aplicá-lo à Produção. Também recomendamos ter um backup recente antes de qualquer manipulação.

  1. Desative a saída do módulo Magento_Banner, conforme descrito em Desativar saída do módulo na documentação do desenvolvedor. O nome do módulo que você precisa usar é Magento_Banner.
  2. Implante seu código. Para o Adobe Commerce na infraestrutura em nuvem, implante conforme descrito no artigo Implante sua loja na documentação do desenvolvedor.
  3. Depois de desabilitar a saída do módulo, o menu não aparece mais no admin.
  4. Você não verá mais a opção Banner ou Dynamic em Conteúdo > Elementos.

Para restaurar a funcionalidade de Blocos Dinâmicos

  1. Edite app/etc/config.php em sua base de código local.

  2. Localize e remova a configuração de saída desativada Magento_Banner.
    Se o menu Blocos Dinâmicos estiver ausente no Admin, verifique se a saída do módulo Magento_Banner não está desabilitada no app/etc/config.php.
    Se Magento_Banner for o único módulo listado em advanced > modules_disable_output, você pode remover esta seção inteira abaixo (todas as 5 linhas):

    code language-none 
    'advanced' =>[         'modules_disable_output' =>[             'Magento_Banner' => '1'        ]     ] ,

    Se outros módulos precisarem permanecer desativados, remova apenas a entrada Magento_Banner e certifique-se de que a entrada final na matriz não termine com uma vírgula à direita; por exemplo:

    code language-none 
    'advanced' =>[         'modules_disable_output' =>[             'First_Disabled_Module' => '1',            'Second_Disabled_Module' => '1'        ]     ] ,

  3. Confirme a alteração e reimplante seu ambiente.

  4. Você não verá mais a opção Banner ou Dynamic em Content > Elementos. Para mostrar as opções novamente, habilite a saída do módulo.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f