Laravel-applicaties.
Wat een Laravel-project direct meekrijgt: APP_KEY en productie-instellingen, SQLite tot je een database toevoegt, migraties als releaseopdracht, een queue-worker en de scheduler.
Laravel wordt herkend aan laravel/framework in composer.json. Je deployt het zoals het is — geen serverconfiguratie, geen extra bestanden in de repository.
Hoe het wordt gebouwd en gestart
- PHP — de laagste van 8.2, 8.3 en 8.4 die voldoet aan de
php-vereiste incomposer.json(8.3 als daar niets staat). - Composer —
composer install --no-dev --optimize-autoloader. - Front-end-assets — heeft
package.jsoneenbuild-script (Vite), dan wordt dat uitgevoerd en wordtpublic/buildmeegenomen. - Bij het starten —
storage:link, daarna worden de config-, route- en view-caches opgebouwd. - HTTPS — je applicatie ziet HTTPS-verzoeken als beveiligd, dus
url(),asset()en redirects gebruikenhttps://zonder dat je zelf proxy's hoeft te vertrouwen.
Variabelen die we voor je instellen
| Variabele | Waarde |
|---|---|
APP_KEY | eenmalig aangemaakt bij de eerste deploy en bewaard bij je variabelen |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | het adres van de applicatie |
LOG_CHANNEL | stderr — zodat het tabblad Logs het log van Laravel toont |
SESSION_DRIVER, CACHE_STORE | redis als de applicatie Valkey heeft, anders file |
Elk ervan kun je vervangen door een eigen variabele met dezelfde naam — bijvoorbeeld SESSION_DRIVER=database. Zie Omgevingsvariabelen.
De database: eerst SQLite
Een nieuwe Laravel-applicatie zonder database bewaart haar data in SQLite — de standaard van Laravel zelf — in storage/app/database.sqlite op de schijf van de applicatie. Het bestand blijft bewaard bij deploys en zit in de dagelijkse back-ups van de applicatie, dus je kunt eerst live gaan en later over een database beslissen.
Voeg je PostgreSQL of MySQL toe aan het project (Overzicht → Diensten → Dienst toevoegen), dan stapt de applicatie bij de volgende deploy daarop over en draaien de migraties daar. Data in het SQLite-bestand gaat niet mee — exporteer die eerst als je haar nodig hebt, en importeer haar op het tabblad Data van de database. Zie Databases.
Migraties — de releaseopdracht
De aanbevolen releaseopdracht is php artisan migrate --force. Die draait één keer bij elke deploy, voordat de nieuwe versie bezoekers krijgt; mislukt een migratie, dan blijft de huidige versie draaien. Je kunt die wijzigen op het tabblad Processen. Zie Deploys.
Queue-worker en scheduler
Standaard draait het tabblad Processen:
| Wat | Opdracht |
|---|---|
| Achtergrondworker «queue» | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Geplande opdracht, elke minuut | php artisan schedule:run |
Ze delen de resources van de applicatie en herstarten bij elke deploy. Wijzig of verwijder ze op het tabblad Processen — vervang de worker bijvoorbeeld door php artisan horizon als je Horizon met Valkey gebruikt.
Voor een zware queue draai je de worker als aparte achtergrondworker-dienst met eigen resources, en haal je hem weg uit Processen. Zie Diensten van een project.
Valkey voor cache, sessies en queues
Voeg Valkey toe aan het project: sessies en cache verhuizen er vanzelf naartoe (bij de volgende deploy; bezoekers moeten één keer opnieuw inloggen). Queues en al het andere stel je in op het tabblad Variabelen, bijv.:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT en REDIS_CLIENT=phpredis worden voor je ingesteld.
WebSockets (Laravel Reverb)
Draai Reverb als webdienst vanuit de code van dit project met de opdracht php artisan reverb:start --host=0.0.0.0 --port=$PORT. De webdienst krijgt een eigen adres.
Bestanden en uploads
Bestanden in storage/app — de disks local en public van Laravel — blijven tussen deploys op de schijf van de applicatie staan en worden dagelijks geback-upt. Al het andere in de projectmap komt bij elke deploy vers uit de repository. Gebruik voor veel of grote bestanden objectopslag met de s3-disk van Laravel.