Skip to content

Údržba ​

Při php artisan down dostane uživatel obrazovku údržby (ne offline stránku ani chybu prohlížeče) a nainstalovaná aplikace nepřijde o cache, přihlášení ani push odběr.

Zapnutí ​

bash
php artisan pwa:down --message="Nasazujeme novou verzi" --until="15:30"
php artisan up
VolbaPopis
--messagetext na obrazovce (jinak maintenance.message nebo přeložený výchozí)
--untiločekávaný konec: 15:30, 2026-11-21 08:00, cokoli pro Carbon::parse
--retrysekundy pro Retry-After; bez něj z --until (omezeno 15–300 s) nebo maintenance.retry
--refreshhlavička Refresh
--secret, --with-secretobejití údržby jako u artisan down

pwa:down je wrapper nad php artisan down --render="pwa::maintenance". Funguje i přímo:

bash
php artisan down --render="pwa::maintenance" --retry=120

Obrazovka ​

Předrenderuje se při down, takže nemá request, session ani auth. Ukazuje zprávu, odhad konce, odpočet do další kontroly a ukazatel průběhu. Každých Retry-After sekund (15–300) pošle HEAD na aktuální URL; jakmile odpověď není 503, stránku znovu načte. Kontroluje i po návratu do aplikace a po obnovení připojení.

Úpravy: publikujte views a upravte maintenance.blade.php. Data z PHP předávejte jen přes data-* atributy elementu #pwa-maintenance, ne do <script>: jinak se změní CSP hash (Bezpečnost).

Service worker při 503 ​

SituaceChování
navigace vrátí 503SW odpověď zobrazí, neukáže offline stránku, nic neuloží
uložené stránkyzůstanou; 503 je nepřepíše
GET z cache.apivrátí se uložená odpověď, jinak 503
fronta offline akcípři 503 čeká dál
otevřená oknadostanou zprávu maintenance (lišta, pwa:maintenance)
kontrola aktualizace /sw.js vrátí 503prohlížeč si nechá stávající SW
pushdoručení nejde přes server; klepnutí otevře obrazovku údržby

Výjimky ​

php
$middleware->preventRequestsDuringMaintenance(except: ['manifest.webmanifest', 'sw.js', 'pwa/*']);

Laravel výjimky respektuje i u předrenderované šablony. S nimi zůstanou dostupné manifest, service worker, keep-alive a telemetrie. pwa:doctor chybějící výjimky hlásí jako varování.

Obejití údržby ​

--secret funguje jako v Laravelu (https://app.test/{secret} nastaví cookie). Na iPhonu se ale odkaz otevře v Safari, ne v aplikaci na ploše, která má vlastní cookies. Bypass testujte na Androidu nebo desktopu, kde aplikace sdílí cookies s prohlížečem.

Livewire a Inertia ​

Akce během údržby dostanou 503; adaptéry místo chybového okna stránku znovu načtou, takže se ukáže obrazovka údržby (Livewire a Inertia).

Released under the MIT License.