Documentazione

Disattiva l'output del banner Adobe Commerce per migliorare le prestazioni del sito

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

Questo articolo fornisce una risoluzione per prestazioni del sito ridotte. Possono verificarsi problemi di prestazioni quando il modulo Magento_Banner è abilitato ma non in uso. La disattivazione dell’output del modulo può migliorare le prestazioni del sito; tuttavia, questa azione rimuove la funzionalità Blocchi dinamici dall’amministratore.

Descrizione description

Ambiente

  • Adobe Commerce su infrastruttura cloud v.2.4.x
  • Adobe Commerce on-premise v.2.4.x

Problema/Sintomi

Il modulo Magento_Banner è abilitato, ma non utilizzato.

Per verificare se questo è il caso:

Per Adobe Commerce su infrastruttura cloud 2.3.x e versioni successive (la funzionalità era rinominata nella versione 2.3.x):

  1. Accedi all’amministratore di Commerce.
  2. Passa a Contenuto > Elementi > Blocchi dinamici.
  3. Se la griglia visualizzata in questa pagina è vuota, non sono presenti blocchi dinamici (banner).

Se non trovi l'opzione Blocchi dinamici in Contenuto > Elementi, significa che hai già applicato il consiglio di questo articolo. Per visualizzare nuovamente l'opzione dei banner, invertire il processo.

Causa principale

Quando il modulo Magento_Banner è abilitato, Adobe Commerce invia richieste Ajax dalla vetrina al server per ottenere le informazioni del banner. Queste richieste Ajax hanno un impatto sulle prestazioni, soprattutto in condizioni di carico elevato (volume elevato e traffico elevato). Se questa funzionalità non viene utilizzata, si consiglia di disabilitare l’output del modulo. Si sconsiglia di disattivare il modulo a causa di problemi di dipendenza.

Risoluzione resolution

Avviso: Si consiglia vivamente di testare le modifiche in Ambiente di staging/integrazione prima di applicarle alla produzione. Consigliamo inoltre di avere un backup recente prima di qualsiasi manipolazione.

  1. Disattivare l'output del modulo Magento_Banner, come descritto in Disattivare l'output del modulo nella documentazione per gli sviluppatori. Il nome del modulo da utilizzare è Magento_Banner.
  2. Distribuisci il codice. Per Adobe Commerce su infrastruttura cloud, esegui la distribuzione come descritto nell'articolo Distribuisci il tuo archivio nella documentazione per gli sviluppatori.
  3. Dopo aver disabilitato l’output del modulo, il menu non viene più visualizzato nell’amministratore.
  4. Non vedrai più il banner o l'opzione dinamica in Contenuto > Elementi.

Ripristinare la funzionalità Blocchi dinamici

  1. Modifica app/etc/config.php nel codebase locale.

  2. Individuare e rimuovere la configurazione di disabilitazione dell'output Magento_Banner.
    Se nell'amministratore manca il menu Blocchi dinamici, verificare che l'output del modulo Magento_Banner non sia disabilitato in app/etc/config.php.
    Se Magento_Banner è l'unico modulo elencato in avanzato > module_disable_output, è possibile rimuovere questa intera sezione di seguito (tutte le 5 righe):

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

    Se altri moduli devono rimanere disabilitati, rimuovere solo la voce Magento_Banner e assicurarsi che la voce finale nell'array non termini con una virgola finale, ad esempio:

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

  3. Esegui il commit della modifica e ridistribuisci l’ambiente.

  4. Non vedrai più il banner o l'opzione Dinamica in Contenuto > Elementi. Per visualizzare nuovamente le opzioni, abilita l'output del modulo.

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