Sonata Extra Bundle: personalizzare gli errori 404 e 500

Introduzione

La personalizzazione delle pagine di errore (404 — pagina non trovata e 500 — errore interno del server) nella vostra applicazione può migliorare l'esperienza dell'utente in situazioni inaspettate. Questa guida vi spiegherà il processo di configurazione delle pagine di errore personalizzate nel SonataExtraBundle.

Prerequisiti

Prima di continuare, ci sono alcuni punti importanti da notare:

• Ambiente di sviluppo: Le pagine di errore personalizzate non vengono visualizzate nell'ambiente di sviluppo. Per vederle in azione, è necessario configurare la tua applicazione in modalità produzione.
• Parametri dell'ambiente: Definisci nel tuo file .env APP_ENV=prod e APP_DEBUG=0.
• Sessione amministratore: Assicuratevi di non essere connessi come amministratore. Si consiglia di utilizzare una sessione per l'amministratore e un'altra (in modalità privata) per testare le pagine di errore.

Fasi di configurazione

Fase 1: aggiornare la configurazione di Sonata Admin

Per prima cosa, aggiungete quanto segue al vostro file di configurazione SonataPage:

sonata_admin:
    catch_exceptions:
        not_found: [404]
        fatal:     [500]

Questa configurazione intercetta le eccezioni interessate e trasmette la risposta alla route _page_internal_error_{key}. SonataPage collega intelligentemente questo a una pagina designata.

Fase 2: Decorare le pagine di errore

Nel pannello di amministrazione "Pagine" di Sonata, individua e seleziona la casella "decorare".

Vedrete le opzioni Page Internal Error Fatal e Page Internal Error Not Found, che sono cruciali per i passaggi successivi.

Fase 3: Traduzione e personalizzazione

Tutti gli elementi delle pagine di errore sono traducibili per ogni locale del sito.

Dopo aver attivato l'opzione « Decorare », salva le tue modifiche e passa al pannello « organizzare ». Qui, puoi personalizzare il contenitore principale della tua pagina di errore.

Fase 4: Pubblicazione delle pagine personalizzate

L'ultimo passaggio consiste nel pubblicare le tue pagine personalizzate. Crea un'istantanea della tua pagina facendo clic sul pannello di pubblicazione.

Conclusione

Dopo aver completato questi passaggi, le vostre pagine di errore personalizzate 404 e 500 dovrebbero essere attive e visibili in modalità produzione.

Con questa configurazione, garantite una migliore esperienza utente anche in caso di errori nella vostra applicazione.

Ricetta minima

Testate un URL inesistente e un errore applicativo controllato nell'ambiente di collaudo. La risposta deve mantenere il codice HTTP corretto (404 o 500) : visualizzare una bella pagina con uno stato 200 degrada il monitoraggio degli incidenti e l’indicizzazione.