Validierung

Was ist Validierung

Validierung bedeutet, zu prüfen, ob vom Nutzer übermittelte Daten das erwartete Format und die Bedingungen erfüllen. Laravel bietet dafür die einfache, aber leistungsfähige validate-Methode am Request-Objekt sowie eigene Form-Request-Klassen.

Validierung im Controller

Nutzung von `$request->validate()`

Der einfachste Weg ist der Aufruf von $request->validate() im Controller. Schlägt die Validierung fehl, leitet Laravel automatisch zurück und speichert die Fehler in der Session. Routen:

use App\Http\Controllers\PostController;

Route::get('/post/create', [PostController::class, 'create']);
Route::post('/post', [PostController::class, 'store']);

Controller:

<?php

namespace App\Http\Controllers;

use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\View\View;

class PostController extends Controller
{
    public function create(): View
    {
        return view('post.create');
    }

    public function store(Request $request): RedirectResponse
    {
        $validated = $request->validate([
            'title' => 'required|string|max:255',
            'body'  => 'required|string',
            'email' => 'required|email',
        ]);

        // Mit den validierten Daten speichern...

        return redirect('/posts');
    }
}

validate erwartet ein Array aus Feldname → Regel. Regeln trennen Sie per Pipe | oder in einem Array.

// Pipe
'title' => 'required|string|max:255',

// Array
'title' => ['required', 'string', 'max:255'],

Wichtige Validierungsregeln

Regel	Bedeutung
`required`	Wert existiert und ist nicht leer
`string`	String
`email`	Gültige E-Mail
`min:Wert`	Länge oder Zahl mindestens angegebener Wert
`max:Wert`	Länge oder Zahl höchstens angegebener Wert
`unique:tabelle`	Wert in der Tabelle einzigartig
`nullable`	`null` ist erlaubt
`integer`	Ganzzahl
`boolean`	Boolean (`true`/`false`, `1`/`0` etc.)
`date`	Gültiges Datumsformat
`confirmed`	Muss mit `feldname_confirmation` übereinstimmen
`array_keys:key1,key2,...`	Array-Schlüssel sind auf die angegebenen Schlüssel beschränkt

Alle Regeln finden Sie in der offiziellen Dokumentation.

Erweiterte E-Mail-Validierung

Die email-Regel akzeptiert Parameter, mit denen Sie festlegen, wie die Adresse validiert wird.

'email' => ['email:rfc,dns'],

Der rfc-Validator prüft die Adresse gegen die unterstützten RFCs, während dns sicherstellt, dass die Domain der Adresse einen gültigen MX-Eintrag besitzt. Der dns-Validator führt einen echten DNS-Lookup aus, prüft aber nicht, ob ein einzelnes Postfach existiert. Dieselbe Validierung lässt sich auch mit dem fluent Rule-Builder formulieren.

use Illuminate\Validation\Rule;

$request->validate([
    'email' => [
        'required',
        Rule::email()
            ->rfcCompliant(strict: false)
            ->validateMxRecord()
            ->preventSpoofing(),
    ],
]);

Der dns-Validator führt einen echten DNS-Lookup aus und bestätigt so, dass die Domain der Adresse einen gültigen MX-Eintrag besitzt. Ob ein einzelnes Postfach existiert, prüft er jedoch nicht. Damit Ihre Tests nicht von echten DNS-Lookups abhängen, faken Sie den dns-Lookup mit Validator::fakeDnsLookups. Andere angeforderte Validierungen wie rfc werden weiterhin ausgeführt.

use Illuminate\Support\Facades\Validator;

Validator::fakeDnsLookups();

So kann Ihre Anwendung ihre bestehenden Validierungsregeln beibehalten, während Sie beispielsweise folgende Regel testen:

'email' => ['required', 'email:rfc,dns'],

Die Validatoren dns und spoof benötigen die PHP-Extension intl.

Array-Schlüssel validieren

Die Regel array_keys prüft, ob der Zielwert ein PHP-Array ist und alle Schlüssel in der angegebenen Liste enthalten sind. Mindestens ein Schlüssel muss angegeben werden.

'user' => ['array_keys:name,username'],

Bei der Verwendung von Rule-Objekten nutzen Sie die Methode Rule::arrayKeys.

use Illuminate\Validation\Rule;

'user' => [Rule::arrayKeys('name', 'username')],

Nutzung der validierten Daten

Der Rückgabewert von validate enthält ausschließlich die validierten Werte – vertrauenswürdig zur Weiterverarbeitung.

$validated = $request->validate([
    'title' => 'required|string|max:255',
    'body'  => 'required|string',
]);

// $validated ist ['title' => '...', 'body' => '...']
Post::create($validated);

Fehleranzeige in Blade

Nach einer fehlgeschlagenen Validierung stellt Laravel automatisch die Variable $errors in allen Views zur Verfügung. Dafür sorgt die Middleware ShareErrorsFromSession aus der web-Gruppe.

Alle Fehler auflisten

@if ($errors->any())
    <ul>
        @foreach ($errors->all() as $error)
            <li>{{ $error }}</li>
        @endforeach
    </ul>
@endif

Fehler pro Feld

Mit @error zeigen Sie inline Fehler eines bestimmten Feldes.

<label for="title">Titel</label>

<input
    id="title"
    type="text"
    name="title"
    value="{{ old('title') }}"
    class="@error('title') is-invalid @enderror"
/>

@error('title')
    <div class="error-message">{{ $message }}</div>
@enderror

Mit old('feldname') behalten Sie den zuvor eingegebenen Wert im Formular auch nach einem Fehler.

Form Requests

Was sind Form Requests

Wenn die Validierungslogik komplexer wird, verlagern Sie sie in eine „Form-Request”-Klasse. Ein Form Request bündelt Validierungs- und Autorisierungslogik in einer eigenen Request-Klasse.

Form Request erzeugen

Mit make:request:

php artisan make:request StorePostRequest

Erzeugt app/Http/Requests/StorePostRequest.php:

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StorePostRequest extends FormRequest
{
    /**
     * Prüft, ob der Nutzer diese Aktion ausführen darf
     */
    public function authorize(): bool
    {
        return true;
    }

    /**
     * Regeln für diesen Request
     *
     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
     */
    public function rules(): array
    {
        return [
            'title' => 'required|string|max:255',
            'body'  => 'required|string',
            'email' => 'required|email|unique:posts',
        ];
    }
}

`rules()`

Gibt die Regeln als Array zurück – gleiches Format wie beim validate-Aufruf.

`authorize()`

Prüft, ob der Nutzer diese Aktion ausführen darf. true = erlaubt, false = automatisches 403 Forbidden. Wollen Sie nur angemeldete Nutzer zulassen, prüfen Sie mit auth()->check(). Für Tutorials reicht true.

Gibt authorize() false zurück, wird die Controller-Methode nicht ausgeführt und ein 403 zurückgegeben.

Injection im Controller

Deklarieren Sie den Form Request einfach als Parameter. Die Validierung läuft vor der Methodenausführung.

use App\Http\Requests\StorePostRequest;

class PostController extends Controller
{
    public function store(StorePostRequest $request): RedirectResponse
    {
        // Kommt der Code hier an, ist alles validiert

        $validated = $request->validated();

        Post::create($validated);

        return redirect('/posts');
    }
}

$request->validated() liefert nur die validierten Daten.

Passwortkomplexität und -länge festlegen

Mit dem Rule-Objekt Password legen Sie Passwortkomplexität sowie Mindest- und Höchstlänge gemeinsam fest.

use Illuminate\Validation\Rules\Password;

Password::min(16)
    ->max(256)
    ->letters()
    ->mixedCase()
    ->numbers()
    ->symbols();

min() gibt die Mindestlänge und max() die maximale Länge an. Durch Setzen von max() können Sie komplexe Passwörter erlauben und zugleich eine Obergrenze deklarieren, die von Ihrer Speicherlösung und der Anbindung an Drittanbieter-Dienste erwartet wird.

Praxisbeispiel: Post-Formular anlegen und speichern

Kompletter Ablauf: Formular anzeigen, absenden, validieren, speichern.

Routen definieren

use App\Http\Controllers\PostController;

Route::get('/posts/create', [PostController::class, 'create']);
Route::post('/posts', [PostController::class, 'store']);

Form Request erzeugen

php artisan make:request StorePostRequest

public function rules(): array
{
    return [
        'title' => 'required|string|max:255',
        'body'  => 'required|string',
    ];
}

public function authorize(): bool
{
    return true;
}

Controller implementieren

use App\Http\Requests\StorePostRequest;
use App\Models\Post;

class PostController extends Controller
{
    public function create(): View
    {
        return view('posts.create');
    }

    public function store(StorePostRequest $request): RedirectResponse
    {
        Post::create($request->validated());

        return redirect('/posts');
    }
}

Blade-Template anlegen

{{-- resources/views/posts/create.blade.php --}}

<h1>Neuer Beitrag</h1>

@if ($errors->any())
    <ul>
        @foreach ($errors->all() as $error)
            <li>{{ $error }}</li>
        @endforeach
    </ul>
@endif

<form method="POST" action="/posts">
    @csrf

    <div>
        <label for="title">Titel</label>
        <input
            id="title"
            type="text"
            name="title"
            value="{{ old('title') }}"
        />
        @error('title')
            <span>{{ $message }}</span>
        @enderror
    </div>

    <div>
        <label for="body">Inhalt</label>
        <textarea id="body" name="body">{{ old('body') }}</textarea>
        @error('body')
            <span>{{ $message }}</span>
        @enderror
    </div>

    <button type="submit">Absenden</button>
</form>

Vergessen Sie in Blade-Formularen nicht das @csrf-Directive – ohne CSRF-Token liefert Laravel Status 419.

Nächste Schritte

HTTP-Requests

Frischen Sie das Abrufen von Daten aus dem Request-Objekt auf.

Erste Schritte

Grundlagen

Request-Verarbeitung

Datenbank

Authentifizierung

Helfer und externe Kommunikation

Tests und Deployment

KI-Entwicklungsunterstützung

Was ist Validierung

Validierung im Controller

Nutzung von `$request->validate()`

Wichtige Validierungsregeln

Erweiterte E-Mail-Validierung

Array-Schlüssel validieren

Nutzung der validierten Daten

Fehleranzeige in Blade

Alle Fehler auflisten

Fehler pro Feld

Form Requests

Was sind Form Requests

Form Request erzeugen

`rules()`

`authorize()`

Injection im Controller

Passwortkomplexität und -länge festlegen

Praxisbeispiel: Post-Formular anlegen und speichern

Nächste Schritte

HTTP-Requests

​Was ist Validierung

​Validierung im Controller

​Nutzung von $request->validate()

​Wichtige Validierungsregeln

​Erweiterte E-Mail-Validierung

​Array-Schlüssel validieren

​Nutzung der validierten Daten

​Fehleranzeige in Blade

​Alle Fehler auflisten

​Fehler pro Feld

​Form Requests

​Was sind Form Requests

​Form Request erzeugen

​rules()

​authorize()

​Injection im Controller

​Passwortkomplexität und -länge festlegen

​Praxisbeispiel: Post-Formular anlegen und speichern

​Nächste Schritte

HTTP-Requests

Was ist Validierung

Validierung im Controller

Nutzung von `$request->validate()`

Wichtige Validierungsregeln

Erweiterte E-Mail-Validierung

Array-Schlüssel validieren

Nutzung der validierten Daten

Fehleranzeige in Blade

Alle Fehler auflisten

Fehler pro Feld

Form Requests

Was sind Form Requests

Form Request erzeugen

`rules()`

`authorize()`

Injection im Controller

Passwortkomplexität und -länge festlegen

Praxisbeispiel: Post-Formular anlegen und speichern

Nächste Schritte