Gestione della pagina di cortesia con Laravel

Per attivare e disattivare la pagina di manutenzione (maintenance mode), che è la pagina di cortesia mostrata durante il deploy, Laravel utilizza due comandi:

Attivare la pagina di cortesia

Per attivare la pagina di cortesia (ovvero passare al “maintenance mode”) si utilizza il comando:

php artisan down

Questo comando mostra la classica pagina di manutenzione a tutti gli utenti, mentre l’amministratore del sito può completare il deploy in sicurezza.

Bypassare la pagina di cortesia

Se si specifica lopzione --with-secret, quando si attiva la pagian di cortesia verrà visualizzato un token segreto. Se si acccede alla pagina corrispondente (ad esempio: https://example.com/1630542a-246b-4b66-afa1-dd72a4c43515) si verrà indirizzati alla homepage dell’applicazione e da lì si potrà normalmente navigare l’applicaizone, anche se è in manutenzione.

php artisan down --with-secret

Disattivare la pagina di cortesia

Per disattivare la pagina di cortesia (ovvero tornare online) si utilizza il comando:

php artisan up

Personalizzare la pagina di cortesia

Laravel permette di personalizzare la pagina di cortesia mostrata quando l’applicazione è in modalità manutenzione. Ci sono due modi principali per farlo:

• creare/personalizzare la pagina resources/views/errors/503.blade.php (metodo da preferire);
• usare un template Blade personalizzato:

Creare la pagina 503.blade.php

Quando si esegue:

php artisan down

Laravel restituisce un errore HTTP “503 – Service Unavailable”.

Se si crea un file Blade personalizzato in resources/views/errors/503.blade.php, Laravel userà automaticamente quel file come pagina di cortesia.

Questo metodo permette di crare pagine con layout simile per gestire i diversi codici di errore HTTP.

Usare un template Blade personalizzato

Se si utilizza il comando:

php artisan down --render="maintenance"

Laravel presenterà la pagina resources/views/maintenance.blade.php.

Se invece si utilizza il comando:

php artisan down --redirect="/manutenzione"

Laravel reindirizzerà l’utente alla route /manutenzione.

Risorse online

Laravel documentation: Maintenance mode.