Jetzt starten

Laravel-Anwendungen.

Was ein Laravel-Projekt von Haus aus bekommt: APP_KEY und Produktionseinstellungen, SQLite bis zur ersten Datenbank, Migrationen als Release-Befehl, einen Queue-Worker und den Scheduler.

3 MIN. LESEZEIT

Laravel wird an laravel/framework in der composer.json erkannt. Sie deployen es so, wie es ist – ohne Serverkonfiguration und ohne zusätzliche Dateien im Repository.

Wie es gebaut und ausgeführt wird

  • PHP – die niedrigste Version aus 8.2, 8.3 und 8.4, die die php-Anforderung in der composer.json erfüllt (8.3, wenn dort nichts angegeben ist).
  • Composer – composer install --no-dev --optimize-autoloader.
  • Frontend-Assets – enthält die package.json ein build-Skript (Vite), wird es ausgeführt und public/build übernommen.
  • Beim Start – storage:link, danach werden Config-, Routen- und View-Cache erstellt.
  • HTTPS – Ihre Anwendung erkennt HTTPS-Anfragen als sicher, sodass url(), asset() und Weiterleitungen https:// verwenden, ohne dass Sie Proxys selbst vertrauen müssen.

Automatisch gesetzte Variablen

VariableWert
APP_KEYeinmalig beim ersten Deployment erzeugt und bei Ihren Variablen gespeichert
APP_ENVproduction
APP_DEBUGfalse
APP_URLdie Adresse der Anwendung
LOG_CHANNELstderr – damit der Tab Logs das Laravel-Log anzeigt
SESSION_DRIVER, CACHE_STOREredis, wenn die Anwendung Valkey hat, sonst file

Jede davon lässt sich durch eine eigene Variable mit demselben Namen ersetzen – zum Beispiel SESSION_DRIVER=database. Siehe Umgebungsvariablen.

Die Datenbank: zuerst SQLite

Eine neue Laravel-Anwendung ohne Datenbank speichert ihre Daten in SQLite – der Voreinstellung von Laravel selbst – unter storage/app/database.sqlite auf der Festplatte der Anwendung. Die Datei übersteht Deployments und ist in den täglichen Backups der Anwendung enthalten, sodass Sie zuerst starten und später über eine Datenbank entscheiden können.

Fügen Sie dem Projekt PostgreSQL oder MySQL hinzu (Übersicht → Dienste → Dienst hinzufügen), wechselt die Anwendung mit dem nächsten Deployment dorthin, und die Migrationen laufen dort. Daten aus der SQLite-Datei werden nicht übernommen – exportieren Sie sie bei Bedarf vorher und importieren Sie sie im Tab Daten der Datenbank. Siehe Datenbanken.

Migrationen – der Release-Befehl

Der empfohlene Release-Befehl ist php artisan migrate --force. Er läuft bei jedem Deployment einmal, bevor die neue Version Besucher erhält; schlägt eine Migration fehl, läuft die aktuelle Version weiter. Sie können ihn im Tab Prozesse ändern. Siehe Deployments.

Queue-Worker und Scheduler

Von Haus aus führt der Tab Prozesse aus:

WasBefehl
Hintergrund-Worker „queue“php artisan queue:work --sleep=3 --tries=3 --max-time=3600
Geplanter Befehl, jede Minutephp artisan schedule:run

Sie teilen sich die Ressourcen der Anwendung und starten bei jedem Deployment neu. Ändern oder entfernen Sie sie im Tab Prozesse – ersetzen Sie zum Beispiel den Worker durch php artisan horizon, wenn Sie Horizon mit Valkey nutzen.

Bei einer stark ausgelasteten Queue betreiben Sie den Worker als separaten Dienst Hintergrund-Worker mit eigenen Ressourcen und entfernen ihn aus Prozesse. Siehe Dienste eines Projekts.

Valkey für Cache, Sessions und Queues

Fügen Sie dem Projekt Valkey hinzu: Sessions und Cache ziehen von selbst dorthin um (mit dem nächsten Deployment; Besucher melden sich einmal neu an). Queues und alles andere legen Sie im Tab Variablen fest, z. B.:

CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis

REDIS_HOST, REDIS_PASSWORD, REDIS_PORT und REDIS_CLIENT=phpredis werden für Sie gesetzt.

WebSockets (Laravel Reverb)

Betreiben Sie Reverb als Webdienst aus dem Code dieses Projekts mit dem Befehl php artisan reverb:start --host=0.0.0.0 --port=$PORT. Er erhält eine eigene Adresse.

Dateien und Uploads

Dateien in storage/app – den Laravel-Disks local und public – bleiben zwischen Deployments auf der Festplatte der Anwendung und werden täglich gesichert. Alles andere im Projektordner kommt bei jedem Deployment frisch aus dem Repository. Für viele oder große Dateien nutzen Sie den Object Storage mit der Laravel-Disk s3.

Noch Fragen?

Schreiben Sie uns im Chat – die AI antwortet sofort, und bei Bedarf kommt ein Techniker dazu, zu jeder Tageszeit.

Support kontaktieren