laravel

Überblick

Laravel ist ein PHP-Webanwendungs-Framework mit ausdrucksvoller, eleganter Syntax. Diese Anleitung führt Sie durch die Bereitstellung einer Laravel-Anwendung auf der NStrim-Plattform von Anfang bis Ende.

Schnellstart

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>

composer install

cp .env.example .env
php artisan key:generate

php artisan migrate
git add .
git commit -m "Initial setup"
git push origin main

Lokale Entwicklung mit Docker

Wenn Sie PHP nicht lokal installiert haben, können Sie Docker verwenden, um Laravel-Befehle auszuführen. Das Projekt enthält ein Dockerfile, das alles Notwendige einrichtet.

Voraussetzungen

Installieren Sie Docker Desktop für Ihr Betriebssystem (Windows, Mac oder Linux).

Befehle mit Docker ausführen

Anstatt php artisan migrate direkt auszuführen, führen Sie es in einem Docker-Container aus:

# Docker-Image erstellen (nur einmal erforderlich)
docker build -t laravel-app .

# Beliebigen Artisan-Befehl ausführen
docker run --rm laravel-app php artisan migrate

# Composer install ausführen
docker run --rm -v $(pwd):/var/www/html laravel-app composer install

# Interaktive Shell im Container
docker run --rm -it -v $(pwd):/var/www/html laravel-app bash

Datenbank-Konfiguration

Die NStrim-Plattform stellt Ihnen eine MySQL/MariaDB-Datenbank zur Verfügung. Sie müssen Ihre .env-Datei mit den korrekten Datenbank-Anmeldedaten konfigurieren, um eine Verbindung herzustellen.

Warum die Datenbank konfigurieren?

Laravel verwendet eine .env-Datei zum Speichern umgebungsspezifischer Konfiguration. Standardmäßig verwendet die Vorlage SQLite (eine dateibasierte Datenbank), aber NStrim bietet MySQL für bessere Leistung und Kompatibilität mit realen Szenarien.

Schritt-für-Schritt-Konfiguration

DB_CONNECTION=sqlite
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=laravel
# DB_USERNAME=root
# DB_PASSWORD=

DB_CONNECTION=mysql
DB_HOST=db.<session-domain>
DB_PORT=3306
DB_DATABASE=<your-username>
DB_USERNAME=<your-username>
DB_PASSWORD=<your-password>

Konfigurationsbeispiel

Wenn Ihr Benutzername student01 und die Session-Domain demo.nstrim.app ist:

DB_CONNECTION=mysql
DB_HOST=db.demo.nstrim.app
DB_PORT=3306
DB_DATABASE=student01
DB_USERNAME=student01
DB_PASSWORD=your-password-from-dashboard

Migrationen ausführen

Migrationen sind Laravels Methode zum Erstellen von Datenbanktabellen. Nach der Konfiguration Ihrer Datenbank führen Sie Migrationen aus, um die erforderlichen Tabellen einzurichten:

php artisan migrate

Wenn Sie alle Migrationen zurücksetzen und erneut ausführen müssen (dies löscht alle Daten):

php artisan migrate:fresh

Um Migrationen mit Seed-Daten auszuführen (wenn Ihr Projekt Seeder hat):

php artisan migrate:fresh --seed

Projektstruktur

Verstehen, wo sich Dateien befinden:

├── app/                  # Anwendungscode
│   ├── Http/
│   │   └── Controllers/  # Hier befinden sich Ihre Controller
│   └── Models/           # Eloquent Models
├── config/               # Konfigurationsdateien
├── database/
│   ├── migrations/       # Datenbank-Migrationen
│   └── seeders/          # Datenbank-Seeder
├── public/               # Öffentliche Assets (CSS, JS, Bilder)
├── resources/
│   └── views/            # Blade Templates
├── routes/
│   └── web.php           # Web-Routen (URL → Controller)
├── .env                  # Umgebungskonfiguration (DB, etc.)
└── composer.json         # PHP-Abhängigkeiten
        

Nützliche Befehle

Fehlerbehebung

Bereitstellungs-Workflow

Jedes Mal, wenn Sie Code zu Git pushen, wird Ihre Anwendung automatisch bereitgestellt:

Ihre bereitgestellte Anwendungs-URL folgt diesem Format:

https://<your-subdomain>-<repo-name>.<session-domain>

Beispiel: https://student01-module-a.demo.nstrim.app