Einführung in Eloquent - Knowledge of Laravel

Was ist das Eloquent-ORM?

Laravel bringt mit Eloquent ein Object-Relational-Mapper (ORM) mit. Eloquent erleichtert die Interaktion mit der Datenbank und setzt das Active-Record-Muster um. Sie legen für jede Tabelle eine passende „Model”-Klasse an und arbeiten über das Modell mit den Datensätzen – zum Lesen, Einfügen, Aktualisieren oder Löschen.

Konfigurieren Sie vor der Nutzung von Eloquent Ihre Datenbankverbindung in config/database.php. Standardmäßig werden die DB_*-Werte aus der .env-Datei verwendet.

Modell erstellen

Ein neues Modell erzeugen Sie mit dem Artisan-Befehl make:model.

php artisan make:model Post

Um gleichzeitig eine Migration zu erstellen, verwenden Sie die Option -m.

php artisan make:model Post -m

Modelle werden im Verzeichnis app/Models abgelegt.

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    // ...
}

Zuordnung von Modell und Tabelle

Eloquent leitet den Tabellennamen automatisch aus dem Klassennamen ab. Der Tabellenname ist der Klassenname in Snake-Case und im Plural.

Modellname	Tabellenname
`Post`	`posts`
`User`	`users`
`AirTrafficController`	`air_traffic_controllers`

Passt der Tabellenname nicht zur Namenskonvention, geben Sie ihn über die Property $table explizit an.

class Post extends Model
{
    protected $table = 'blog_posts';
}

Zeitstempel

Standardmäßig verwaltet Eloquent die Spalten created_at und updated_at automatisch. Wenn Sie in der Migration $table->timestamps() einfügen, werden die Werte beim Speichern oder Aktualisieren automatisch gesetzt. Um die automatische Zeitstempelverwaltung zu deaktivieren, setzen Sie $timestamps auf false.

class Post extends Model
{
    public $timestamps = false;
}

Schutz vor Mass Assignment

Beim gleichzeitigen Zuweisen mehrerer Werte über Eloquent muss der Schutz vor Mass Assignment konfiguriert sein.

fillable

Erlauben Sie die Zuweisung bestimmter Spalten über die Property $fillable.

class Post extends Model
{
    protected $fillable = [
        'user_id',
        'title',
        'body',
        'published',
    ];
}

guarded

Umgekehrt geben Sie mit $guarded an, welche Spalten geschützt sind.

class Post extends Model
{
    // Nur der Primärschlüssel ist geschützt, alles andere ist erlaubt
    protected $guarded = ['id'];
}

Ein leeres Array bei $guarded erlaubt die Zuweisung an alle Spalten. Übergeben Sie Nutzereingaben direkt, besteht die Gefahr, dass ungewollt Spalten überschrieben werden. Es empfiehlt sich daher, gezielt mit $fillable freizugeben.

Ausführungsablauf einer Eloquent-Query

Nachfolgend sehen Sie, wie eine Abfrage wie User::where()->get() intern abläuft.

Grundlegende CRUD-Operationen

Datensätze lesen (Read)

Alle Datensätze abrufen:

use App\Models\Post;

$posts = Post::all();

Mit Bedingungen abfragen:

// Alle Beiträge mit published = true
$publishedPosts = Post::where('published', true)->get();

// Nur der erste Datensatz
$post = Post::where('published', true)->first();

// Ein Datensatz per ID
$post = Post::find(1);

// Nicht gefunden ⇒ 404-Antwort
$post = Post::findOrFail(1);

Datensätze anlegen (Create)

Mit create fügen Sie einen Datensatz ein (die Property $fillable muss konfiguriert sein).

$post = Post::create([
    'title' => 'Mein erster Beitrag',
    'body' => 'Laravel ist ein großartiges Framework.',
    'published' => true,
]);

Alternativ instanziieren Sie das Modell und weisen die Werte einzeln zu.

$post = new Post;
$post->title = 'Mein erster Beitrag';
$post->body = 'Laravel ist ein großartiges Framework.';
$post->save();

Datensätze aktualisieren (Update)

Laden Sie das Modell, ändern Sie den Wert und rufen Sie save auf.

$post = Post::find(1);
$post->title = 'Aktualisierter Titel';
$post->save();

Mit update aktualisieren Sie mehrere Spalten gleichzeitig.

Post::find(1)->update([
    'title' => 'Aktualisierter Titel',
    'published' => true,
]);

Mehrere Datensätze lassen sich per Bedingung gemeinsam aktualisieren.

Post::where('published', false)->update(['published' => true]);

Datensätze löschen (Delete)

Rufen Sie delete auf einem Modell auf.

$post = Post::find(1);
$post->delete();

Alternativ können Sie direkt per ID löschen.

Post::destroy(1);

// Mehrere IDs zusammen löschen
Post::destroy([1, 2, 3]);

Grundlegende Query-Methoden

Methode	Beschreibung
`Post::all()`	Alle Datensätze abrufen
`Post::find($id)`	Datensatz per ID abrufen (bei Nichtfinden `null`)
`Post::findOrFail($id)`	Datensatz per ID abrufen (bei Nichtfinden 404)
`Post::where('column', 'value')->get()`	Datensätze mit passender Bedingung abrufen
`Post::where('column', 'value')->first()`	Ersten passenden Datensatz abrufen
`Post::where('column', 'value')->count()`	Anzahl passender Datensätze
`Post::orderBy('created_at', 'desc')->get()`	Sortierung angeben
`Post::latest()->get()`	Nach `created_at` absteigend sortiert abrufen
`Post::limit(10)->get()`	Begrenzte Anzahl abrufen

Praxisbeispiel: Datenverwaltung mit einem Post-Modell

Beispiel für einen Controller, der die per Migration erzeugte Tabelle posts verwaltet.

<?php

namespace App\Http\Controllers;

use App\Models\Post;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;

class PostController extends Controller
{
    // Beitragsliste anzeigen
    public function index(): View
    {
        $posts = Post::where('published', true)
            ->latest()
            ->get();

        return view('posts.index', ['posts' => $posts]);
    }

    // Beitrag anlegen
    public function store(Request $request): RedirectResponse
    {
        $validated = $request->validate([
            'title' => ['required', 'string', 'max:255'],
            'body' => ['required', 'string'],
            'published' => ['boolean'],
        ]);

        Post::create([
            ...$validated,
            'user_id' => $request->user()->id,
        ]);

        return redirect('/posts');
    }

    // Beitrag aktualisieren
    public function update(Request $request, Post $post): RedirectResponse
    {
        $validated = $request->validate([
            'title' => ['required', 'string', 'max:255'],
            'body' => ['required', 'string'],
        ]);

        $post->update($validated);

        return redirect('/posts');
    }

    // Beitrag löschen
    public function destroy(Post $post): RedirectResponse
    {
        $post->delete();

        return redirect('/posts');
    }
}

Wenn Sie eine Controller-Methode mit dem Parameter Post $post versehen, lädt Laravel das Modell automatisch anhand des Route-Parameters (Route Model Binding). Sie müssen Post::findOrFail($id) also nicht selbst schreiben.

Lebenszyklus der Modell-Events

Der folgende Ablauf zeigt, welche Events beim Aufruf von save() ausgelöst werden. Ob es sich um ein Neu-Anlegen oder ein Aktualisieren handelt, entscheidet, welche Events zwischen saving und saved gefeuert werden – letztere werden in beiden Fällen ausgelöst.

Nächste Schritte

Migrationen

Frischen Sie auf, wie Sie mit Migrationen Tabellen für Eloquent anlegen.

​Was ist das Eloquent-ORM?

​Modell erstellen

​Zuordnung von Modell und Tabelle

​Zeitstempel

​Schutz vor Mass Assignment

​fillable

​guarded

​Ausführungsablauf einer Eloquent-Query

​Grundlegende CRUD-Operationen

​Datensätze lesen (Read)

​Datensätze anlegen (Create)

​Datensätze aktualisieren (Update)

​Datensätze löschen (Delete)

​Grundlegende Query-Methoden

​Praxisbeispiel: Datenverwaltung mit einem Post-Modell

​Lebenszyklus der Modell-Events

​Nächste Schritte

Migrationen

Was ist das Eloquent-ORM?

Modell erstellen

Zuordnung von Modell und Tabelle

Zeitstempel

Schutz vor Mass Assignment

fillable

guarded

Ausführungsablauf einer Eloquent-Query

Grundlegende CRUD-Operationen

Datensätze lesen (Read)

Datensätze anlegen (Create)

Datensätze aktualisieren (Update)

Datensätze löschen (Delete)

Grundlegende Query-Methoden

Praxisbeispiel: Datenverwaltung mit einem Post-Modell

Lebenszyklus der Modell-Events

Nächste Schritte