Aplikace v Laravelu.
Co projekt v Laravelu dostane hned po nasazení: APP_KEY a produkční nastavení, SQLite, dokud nepřidáte databázi, migrace jako příkaz při vydání, worker front a plánovač.
Laravel poznáme podle laravel/framework v composer.json. Nasadíte ho tak, jak je — bez konfigurace serveru a bez dalších souborů v repozitáři.
Jak se sestavuje a spouští
- PHP — nejnižší z verzí 8.2, 8.3 a 8.4, která splňuje požadavek
phpvcomposer.json(8.3, když tam nic není). - Composer —
composer install --no-dev --optimize-autoloader. - Front-endové soubory — pokud má
package.jsonskriptbuild(Vite), spustí se apublic/buildse přibalí. - Při spuštění —
storage:link, pak se sestaví cache konfigurace, rout a šablon. - HTTPS — vaše aplikace vidí HTTPS požadavky jako zabezpečené, takže
url(),asset()i přesměrování používajíhttps://, aniž byste sami museli nastavovat důvěryhodné proxy.
Proměnné nastavené za vás
| Proměnná | Hodnota |
|---|---|
APP_KEY | vygeneruje se jednou při prvním nasazení a uloží se k vašim proměnným |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | adresa aplikace |
LOG_CHANNEL | stderr — aby karta Logy ukazovala log Laravelu |
SESSION_DRIVER, CACHE_STORE | redis, když má aplikace Valkey, jinak file |
Kteroukoli z nich můžete nahradit vlastní proměnnou se stejným názvem — například SESSION_DRIVER=database. Viz Proměnné prostředí.
Databáze: nejdřív SQLite
Nová aplikace v Laravelu bez databáze uchovává data v SQLite — výchozí volbě samotného Laravelu — v storage/app/database.sqlite na disku aplikace. Soubor přežije nasazení a je součástí denních záloh aplikace, takže můžete nejdřív spustit a o databázi rozhodnout později.
Když k projektu přidáte PostgreSQL nebo MySQL (Přehled → Služby → Přidat službu), aplikace na ni s dalším nasazením přejde a migrace proběhnou tam. Data ze souboru SQLite se nepřenášejí — pokud je potřebujete, nejdřív je vyexportujte a naimportujte na kartě Data databáze. Viz Databáze.
Migrace — příkaz při vydání
Doporučený příkaz při vydání je php artisan migrate --force. Spustí se jednou při každém nasazení, dřív než nová verze dostane návštěvníky; pokud migrace selže, dál běží aktuální verze. Změnit ho můžete na kartě Procesy. Viz Nasazení.
Worker front a plánovač
Karta Procesy ve výchozím stavu spouští:
| Co | Příkaz |
|---|---|
| Worker na pozadí „queue“ | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Plánovaný příkaz, každou minutu | php artisan schedule:run |
Sdílejí prostředky aplikace a restartují se s každým nasazením. Změnit nebo odebrat je můžete na kartě Procesy — například worker nahradit příkazem php artisan horizon, pokud používáte Horizon s Valkey.
Pro náročnou frontu spusťte worker jako samostatnou službu worker na pozadí s vlastními prostředky a z Procesů ho odeberte. Viz Služby projektu.
Valkey pro cache, relace a fronty
Přidejte k projektu Valkey: relace i cache se na něj přesunou samy (s dalším nasazením; návštěvníci se budou muset jednou znovu přihlásit). Fronty a cokoli dalšího nastavíte na kartě Proměnné, např.:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT a REDIS_CLIENT=phpredis jsou nastavené za vás.
WebSockety (Laravel Reverb)
Reverb spusťte jako webovou službu z kódu tohoto projektu příkazem php artisan reverb:start --host=0.0.0.0 --port=$PORT. Dostane vlastní adresu.
Soubory a nahrávání
Soubory v storage/app — disky local a public v Laravelu — zůstávají mezi nasazeními na disku aplikace a denně se zálohují. Vše ostatní ve složce projektu přichází s každým nasazením čerstvě z repozitáře. Pro hodně souborů nebo velké soubory použijte objektové úložiště s diskem s3 v Laravelu.