Aan de slag

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.

3 MIN LEESTIJD

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 in composer.json (8.3 als daar niets staat).
  • Composer — composer install --no-dev --optimize-autoloader.
  • Front-end-assets — heeft package.json een build-script (Vite), dan wordt dat uitgevoerd en wordt public/build meegenomen.
  • 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 gebruiken https:// zonder dat je zelf proxy's hoeft te vertrouwen.

Variabelen die we voor je instellen

VariabeleWaarde
APP_KEYeenmalig aangemaakt bij de eerste deploy en bewaard bij je variabelen
APP_ENVproduction
APP_DEBUGfalse
APP_URLhet adres van de applicatie
LOG_CHANNELstderr — zodat het tabblad Logs het log van Laravel toont
SESSION_DRIVER, CACHE_STOREredis 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:

WatOpdracht
Achtergrondworker «queue»php artisan queue:work --sleep=3 --tries=3 --max-time=3600
Geplande opdracht, elke minuutphp 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=redis

REDIS_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.

Kom je er niet uit?

Chat met ons — de AI antwoordt meteen en een technicus komt erbij als dat nodig is, op elk moment van de dag.

Contact met support