Laravel-applikationer.
Det får et Laravel-projekt fra start: APP_KEY og produktionsindstillinger, SQLite, indtil du tilføjer en database, migreringer som release-kommando, en køproces og scheduleren.
Laravel genkendes på laravel/framework i composer.json. Du deployer det, som det er – ingen serverkonfiguration og ingen ekstra filer i repositoriet.
Sådan bygges og køres det
- PHP – den laveste af 8.2, 8.3 og 8.4, der opfylder kravet
phpicomposer.json(8.3, hvis der ikke står noget). - Composer –
composer install --no-dev --optimize-autoloader. - Front-end-filer – hvis
package.jsonhar etbuild-script (Vite), køres det, ogpublic/buildtages med. - Ved start –
storage:link, derefter bygges cache for konfiguration, routes og views. - HTTPS – din applikation ser HTTPS-forespørgsler som sikre, så
url(),asset()og omdirigeringer brugerhttps://, uden at du selv skal stole på proxyer.
Variabler, der sættes for dig
| Variabel | Værdi |
|---|---|
APP_KEY | genereres én gang ved første deploy og gemmes sammen med dine variabler |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | applikationens adresse |
LOG_CHANNEL | stderr – så fanen Logs viser Laravels log |
SESSION_DRIVER, CACHE_STORE | redis, når applikationen har Valkey, ellers file |
Alle kan erstattes af din egen variabel med samme navn – for eksempel SESSION_DRIVER=database. Se Miljøvariabler.
Databasen: først SQLite
En ny Laravel-applikation uden database gemmer sine data i SQLite – Laravels eget standardvalg – i storage/app/database.sqlite på applikationens disk. Filen overlever deploys og er med i applikationens daglige backups, så du kan gå i luften først og vælge database senere.
Når du tilføjer PostgreSQL eller MySQL til projektet (Oversigt → Tjenester → Tilføj en tjeneste), skifter applikationen til den ved næste deploy, og migreringerne køres dér. Data i SQLite-filen flyttes ikke med – eksportér dem først, hvis du skal bruge dem, og importér dem på databasens fane Data. Se Databaser.
Migreringer – release-kommandoen
Den anbefalede release-kommando er php artisan migrate --force. Den køres én gang ved hver deploy, før den nye version får besøgende; fejler en migrering, kører den nuværende version videre. Du kan ændre den på fanen Processer. Se Deploys.
Køproces og scheduler
Fra start kører fanen Processer:
| Hvad | Kommando |
|---|---|
| Baggrundsproces «queue» | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Planlagt kommando, hvert minut | php artisan schedule:run |
De deler applikationens ressourcer og genstarter ved hver deploy. Du kan ændre eller fjerne dem på fanen Processer – for eksempel erstatte processen med php artisan horizon, når du bruger Horizon med Valkey.
Ved en tung kø kan du køre processen som en separat tjeneste af typen baggrundsproces med egne ressourcer og fjerne den fra Processer. Se Et projekts tjenester.
Valkey til cache, sessioner og køer
Tilføj Valkey til projektet: sessioner og cache flytter automatisk derover (ved næste deploy; besøgende skal logge ind igen én gang). Køer og alt andet indstiller du på fanen Variabler, f.eks.:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT og REDIS_CLIENT=phpredis sættes for dig.
WebSockets (Laravel Reverb)
Kør Reverb som en webtjeneste fra dette projekts kode med kommandoen php artisan reverb:start --host=0.0.0.0 --port=$PORT. Den får sin egen adresse.
Filer og uploads
Filer i storage/app – Laravels diske local og public – bliver på applikationens disk mellem deploys og tages med i den daglige backup. Alt andet i projektmappen hentes på ny fra repositoriet ved hver deploy. Til mange eller store filer kan du bruge objektlager med Laravels s3-disk.