Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Laravel
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Laravel ist das meistgenutzte Web-Framework für PHP. Es bringt fast alles mit, was eine Webanwendung braucht: Routen, Datenbankzugriff über Objekte (Eloquent), Migrationen für Tabellen, Vorlagen (Blade), Anmeldung, Warteschlangen und das Befehlszeilenwerkzeug artisan, das Code-Gerüste erzeugt und Aufgaben erledigt.
Vorbemerkungen
- Installation pro Projekt: Laravel wird mit Composer in jedes Projekt einzeln installiert. Aus den Ubuntu-Paketquellen kommen nur PHP, seine Erweiterungen und Composer.
- Datenbank: Neue Projekte verwenden SQLite. Die Datenbank ist eine Datei im Projektordner, ein Datenbankserver ist nicht nötig. Anders als bei Express bleiben die Notizen deshalb auch nach einem Neustart erhalten.
- Kein Webserver nötig: Zum Entwickeln startet
php artisan serveeinen eingebauten Server auf http://127.0.0.1:8000, nur vom eigenen Rechner aus erreichbar. Port 8000 darf nicht von einem anderen Programm belegt sein. - Gleiches Beispiel: Das Projekt bekommt dieselbe kleine Notiz-Schnittstelle wie die Anleitungen zu Express, ASP.NET Core und Axum und Actix-web. Bei Laravel liegen alle Adressen der Schnittstelle unter
/api. - Version: Getestet mit Laravel 13.33 (Projektvorlage 13.10), PHP 8.5 und Composer 2.9 unter Ubuntu 26.04. Laravel 13 braucht PHP 8.3 oder neuer.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Versionen kennt.
sudo apt update
2. PHP, Erweiterungen und Composer installieren
php-cliführt PHP im Terminal aus, auch den Entwicklungsserver.php-sqlite3verbindet PHP mit SQLite.xml,mbstring,curl,intlundzipbraucht Laravel für XML, Umlaute, Anfragen an andere Server, Sprachen und das Entpacken von Paketen.unzipundcomposerladen und entpacken Laravel und alle Bibliotheken.
Sind Pakete schon vorhanden, meldet apt das nur.
sudo apt install php-cli php-sqlite3 php-xml php-mbstring php-curl php-intl php-zip unzip composer
Prüfen: Die Ausgabe beginnt mit Composer version 2.
composer --version
Erstes Projekt
3. In das Home-Verzeichnis wechseln
Das Projekt wird im aktuellen Ordner angelegt.
cd ~
4. Projekt anlegen
Lädt die Projektvorlage laravel/laravel samt aller Bibliotheken in den Ordner meinlaravel. Danach erzeugt Laravel selbst einen geheimen Schlüssel in der Datei .env, legt die SQLite-Datei database/database.sqlite an und erstellt darin die Grundtabellen für Benutzer, Zwischenspeicher und Warteschlangen.
composer create-project laravel/laravel meinlaravel
Prüfen: Die Ausgabe enthält Application key set successfully. und endet mit drei Zeilen … DONE, z. B. 0001_01_01_000000_create_users_table … DONE.
5. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinlaravel
Prüfen: Die Ausgabe lautet Laravel Framework 13.33.0 oder nennt eine neuere Version.
php artisan --version
6. Unterstützung für Schnittstellen einrichten
Neue Projekte sind für Webseiten eingerichtet. Dieser Befehl legt zusätzlich die Datei routes/api.php an. Alle Routen darin sind unter /api erreichbar und brauchen keinen Schutz gegen gefälschte Formulare (CSRF-Token), den Laravel sonst für jede POST-Anfrage verlangt. Außerdem installiert er das Paket Sanctum für die Anmeldung per Token. --without-migration-prompt verhindert eine Rückfrage, die Tabellen legt Schritt 12 an.
php artisan install:api --without-migration-prompt
Prüfen: Die Ausgabe endet mit API scaffolding installed. Den Hinweis auf HasApiTokens brauchst du erst, wenn sich Benutzer per Token anmelden sollen.
7. Migration für die Notizen anlegen
Eine Migration beschreibt in PHP, wie eine Tabelle aussieht. Laravel erkennt am Namen create_notizen_table, dass eine Tabelle notizen entstehen soll, und legt eine passende Vorlage im Ordner database/migrations an. Der Dateiname beginnt mit Datum und Uhrzeit, damit Migrationen in der richtigen Reihenfolge laufen.
php artisan make:migration create_notizen_table
Prüfen: Die Ausgabe lautet Migration [database/migrations/…_create_notizen_table.php] created successfully.
8. Spalte für den Titel ergänzen
Die Vorlage enthält nur eine laufende Nummer (id) und die Zeitstempel created_at und updated_at. Das Sternchen * im Befehl steht für Datum und Uhrzeit im Dateinamen, so musst du sie nicht abtippen.
nano database/migrations/*_create_notizen_table.php
Drücke Strg+W, gib $table->id(); ein und drücke Enter. Drücke Ende und dann Enter für eine neue Zeile und füge ein:
$table->string('titel');
Der Block sieht danach so aus:
Schema::create('notizen', function (Blueprint $table) {
$table->id();
$table->string('titel');
$table->timestamps();
});
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
9. Model anlegen
Ein Model steht in Laravel für eine Tabelle. Über die Klasse Notiz liest und schreibt man später Notizen, ohne SQL zu schreiben.
php artisan make:model Notiz
Prüfen: Die Ausgabe lautet Model [app/Models/Notiz.php] created successfully.
10. Model ausfüllen
nano app/Models/Notiz.php
Ersetze den ganzen Inhalt: Drücke Alt+\ (an den Anfang), Alt+A (Markierung beginnen), Alt+/ (ans Ende) und Strg+K (Markiertes löschen). Füge dann diesen Inhalt ein:
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Notiz extends Model
{
// Tabellenname festlegen, sonst sucht Laravel nach "notizs"
protected $table = 'notizen';
// Nur dieses Feld darf per Notiz::create() gefüllt werden
protected $fillable = ['titel'];
// Diese Felder erscheinen im JSON
protected $visible = ['id', 'titel'];
}
$table– Laravel bildet den Tabellennamen sonst nach englischen Regeln aus dem Klassennamen und käme aufnotizs.$fillable– schützt davor, dass jemand über die Schnittstelle andere Spalten wieidmitschickt und überschreibt.$visible– ohne diese Zeile stünden auchcreated_atundupdated_atim JSON.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Routen schreiben
In routes/api.php legt man fest, welche Funktion welche Adresse und Methode beantwortet.
nano routes/api.php
Ersetze den ganzen Inhalt wie in Schritt 10 und füge ein:
<?php
use App\Models\Notiz;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;
// GET /api/hallo?name=... liefert eine Begrüßung als JSON
Route::get('/hallo', function (Request $request) {
return ['gruss' => 'Hallo ' . $request->query('name', 'Welt') . '!'];
});
// GET /api/notizen liefert alle Notizen aus der Datenbank
Route::get('/notizen', function () {
return Notiz::orderBy('id')->get();
});
// POST /api/notizen legt eine Notiz an; der Inhalt kommt als JSON
Route::post('/notizen', function (Request $request) {
if (! $request->filled('titel')) {
return response()->json(['fehler' => 'Feld "titel" fehlt'], 400);
}
$notiz = Notiz::create(['titel' => $request->input('titel')]);
return response()->json($notiz, 201)->header('Location', '/api/notizen/' . $notiz->id);
});
// Alle anderen Adressen unter /api: 404 als JSON
Route::fallback(function () {
return response()->json(['fehler' => 'Nicht gefunden'], 404);
});
Route::getundRoute::post– verbinden Adresse und Methode mit einer Funktion.$requestenthält die Anfrage:query()liest Werte aus der Adresse,input()undfilled()lesen den mitgeschickten JSON-Inhalt.- Gibt eine Funktion ein Array oder Model zurück, wandelt Laravel es selbst in JSON um. Mit
response()->json(…, 201)setzt man zusätzlich den HTTP-Status. Notiz::orderBy('id')->get()liest alle Notizen,Notiz::create()speichert eine neue.Route::fallback– beantwortet alle übrigen Adressen unter/apimit404als JSON.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
12. Tabellen anlegen
Führt alle Migrationen aus, die noch nicht gelaufen sind: die Tabelle notizen und die Tabelle von Sanctum aus Schritt 6.
php artisan migrate
Prüfen: Die Ausgabe enthält …_create_notizen_table … DONE und …_create_personal_access_tokens_table … DONE.
13. Routen anzeigen
Listet alle Routen unter /api auf. So siehst du, ob Laravel die Datei aus Schritt 11 fehlerfrei gelesen hat.
php artisan route:list --path=api
Prüfen: Die Liste enthält GET|HEAD api/hallo, GET|HEAD api/notizen, POST api/notizen und GET|HEAD api/{fallbackPlaceholder} und endet mit Showing [4] routes.
Starten und testen
14. Entwicklungsserver starten
Das Terminal bleibt belegt, solange der Server läuft. Hier erscheint zu jeder Anfrage eine Zeile mit Uhrzeit, Adresse und Dauer.
php artisan serve
Prüfen: Die Ausgabe lautet Server running on [http://127.0.0.1:8000]. Unter http://127.0.0.1:8000 zeigt der Browser die Willkommensseite von Laravel.
Ist Port 8000 schon belegt, etwa von einem zweiten php artisan serve in einem anderen Terminal, weicht Laravel ohne Rückfrage auf 8001 aus. Achte deshalb auf die Portnummer in der Ausgabe.
15. Notiz anlegen
Öffne ein zweites Terminal und schicke eine neue Notiz als JSON an den Server. -i zeigt zusätzlich die Kopfzeilen der Antwort.
curl -i -X POST http://localhost:8000/api/notizen -H "Content-Type: application/json" -d '{"titel": "Erste Notiz"}'
Prüfen: Die erste Zeile lautet HTTP/1.1 201 Created, weiter unten steht Location: /api/notizen/1, die letzte Zeile ist {"titel":"Erste Notiz","id":1}.
16. Weitere Adressen testen
Diese Aufrufe zeigen die übrigen Routen und die Fehlerbehandlung:
| Aufruf | Antwort |
|---|---|
curl http://localhost:8000/api/notizen | [{"id":1,"titel":"Erste Notiz"}] |
curl "http://localhost:8000/api/hallo?name=Thorsten" | {"gruss":"Hallo Thorsten!"} |
curl -X POST http://localhost:8000/api/notizen -H "Content-Type: application/json" -d '{}' | {"fehler":"Feld \"titel\" fehlt"} (Status 400) |
curl http://localhost:8000/api/gibtsnicht | {"fehler":"Nicht gefunden"} (Status 404) |
17. Änderung ohne Neustart ausprobieren
PHP liest den Code bei jeder Anfrage neu. Ein Neustart des Servers ist deshalb nicht nötig. Ändere in routes/api.php das Wort Hallo in der Route /hallo z. B. in Servus und speichere die Datei.
Prüfen: curl http://localhost:8000/api/hallo liefert sofort {"gruss":"Servus Welt!"}.
Nur Änderungen an der Datei .env erfordern einen Neustart. php artisan serve erkennt sie selbst und startet neu.
18. Server beenden
Wechsle in das erste Terminal und drücke Strg+C.
Prüfen: Startest du den Server mit php artisan serve erneut, liefert curl http://localhost:8000/api/notizen weiterhin die Notiz aus Schritt 15. Sie liegt in database/database.sqlite.
Wie geht es weiter?
- Validierung: Statt
filled()prüft$request->validate(['titel' => 'required|max:200'])Eingaben mit Regeln. Schickt der AufrufAccept: application/jsonmit, antwortet Laravel bei Fehlern mit Status 422 und einer Liste der Fehler. - Controller: Bei mehr als ein paar Routen gehört der Code in Controller-Klassen.
php artisan make:controller NotizController --api --model=Notizerzeugt eine Klasse mit allen Methoden zum Lesen, Anlegen, Ändern und Löschen. - Webseiten: Routen in
routes/web.phpliefern HTML aus Blade-Vorlagen im Ordnerresources/views. - Andere Datenbank: Mit dem Paket
php-pgsqlund den EinträgenDB_CONNECTION=pgsql,DB_HOST,DB_DATABASE,DB_USERNAMEundDB_PASSWORDin.envverwendet Laravel PostgreSQL. - Betrieb: Auf einem Server liefert nginx mit PHP-FPM den Ordner
publicaus, wie in den Anleitungen zu Bolt CMS oder Contao. Setze dort in.envdie WerteAPP_ENV=productionundAPP_DEBUG=false, sonst zeigt Laravel Besuchern bei Fehlern Code und Einstellungen. - Aktualisieren:
composer updateim Projektordner holt neue Versionen innerhalb von Laravel 13. Danachphp artisan migrate, falls neue Migrationen dazugekommen sind.
Deinstallieren
1. Server beenden
Läuft php artisan serve noch in einem Terminal, beende es dort mit Strg+C.
2. Projekt entfernen
Löscht den Projektordner samt Bibliotheken und SQLite-Datenbank.
rm -rf ~/meinlaravel
Prüfen: Der Projektordner existiert nicht mehr, ls meldet Datei oder Verzeichnis nicht gefunden.
ls ~/meinlaravel
3. Composer-Zwischenspeicher leeren (optional)
Composer bewahrt heruntergeladene Pakete in ~/.cache/composer auf. Dieser Befehl leert den ganzen Speicher. Das betrifft alle PHP-Projekte, die ihre Pakete dann beim nächsten Mal wieder aus dem Internet laden.
composer clear-cache
4. PHP-Pakete entfernen (optional)
Nur ausführen, wenn kein anderes Programm sie braucht, z. B. die CMS-Anleitungen mit PHP.
sudo apt purge php-sqlite3 composer
Der nächste Befehl entfernt die Pakete, die nur dafür mitinstalliert wurden. Er entfernt aber auch alle anderen nicht mehr benötigten Pakete, auch solche von früheren Installationen. Lies daher die Liste, bevor du mit J bestätigst. Stehen dort Pakete, die du noch brauchst, brich mit N ab.
sudo apt autoremove --purge
Quellen und Lizenz
- Offizielle Dokumentation: https://laravel.com/docs
- Lizenz: Laravel steht unter der MIT.
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.