Basics - 10.1. List of all available validation rules and their function

Das zu validierende Feld muss yes, on, 1 oder true sein. Dies ist nützlich, um die Akzeptanz der "Allgemeinen Geschäftsbedingungen" zu überprüfen.

Das zu validierende Feld muss einen gültigen A oder AAAA-Eintrag gemäß der PHP-Funktion dns_get_record haben.

Das zu validierende Feld muss ein Wert nach einem bestimmten Datum sein. Die Daten werden in die strtotime PHP-Funktion übergeben:

'start_date' => 'required|date|after:tomorrow'

Anstatt eine Datumszeichenkette zu übergeben, die von strtotime ausgewertet werden soll, können Sie ein anderes Feld angeben, das mit dem Datum verglichen werden soll:

'finish_date' => 'required|date|after:start_date'

Das zu validierende Feld muss ein Wert nach oder gleich dem angegebenen Datum sein. Weitere Informationen finden Sie in der after-Regel.

Das zu validierende Feld muss vollständig alphabetisch sein.

Das zu validierende Feld kann alphanumerische Zeichen sowie Bindestriche und Unterstriche enthalten.

Das zu prüfende Feld muss vollständig alphanumerische Zeichen enthalten.

Das zu überprüfende Feld muss ein PHP-Array sein.

Beenden Sie die Ausführung von Validierungsregeln nach dem ersten Validierungsfehler.

Das zu validierende Feld muss ein Wert sein, der dem angegebenen Datum vorausgeht. Die Daten werden an die PHP Strtotime-Funktion übergeben. Darüber hinaus kann wie bei der After-Regel der Name eines anderen zu validierenden Feldes als Wert des Datums angegeben werden.

Das zu validierende Feld muss ein Wert sein, der dem angegebenen Datum vorausgeht oder gleich ist. Die Daten werden an die PHP Strtotime-Funktion übergeben. Darüber hinaus kann wie bei der After-Regel der Name eines anderen zu validierenden Feldes als Wert des Datums angegeben werden.

Das zu validierende Feld muss eine Größe zwischen dem angegebenen Minimum und dem Maximum haben. Zeichenketten, Zahlen, Arrays und Dateien werden auf die gleiche Weise wie die size Regel ausgewertet.

Das zu validierende Feld muss als Boolescher Guss vorliegen können. Akzeptierte Eingaben sind wahr, falsch, 1, 0, "1" und "0".

Das zu validierende Feld muss ein passendes Feld von foo_confirmation haben. Wenn es sich bei dem zu validierenden Feld beispielsweise um ein Passwort handelt, muss in der Eingabe ein passendes password_confirmation-Feld vorhanden sein.

Das zu validierende Feld muss ein gültiges, nicht-relatives Datum gemäß der PHP-Funktion strtotime sein.

Das Feld unter Validierung muss gleich dem angegebenen Datum sein. Die Daten werden an die PHP Strtotime-Funktion übergeben.

Das zu prüfende Feld muss dem angegebenen Format entsprechen. Sie sollten bei der Validierung eines Feldes entweder date oder date_format verwenden, nicht beides. Diese Validierungsregel unterstützt alle Formate, die von der DateTime-Klasse von PHP unterstützt werden.

Das zu validierende Feld muss einen anderen Wert haben als das Feld.

Das zu prüfende Feld muss numerisch sein und eine genaue Länge des Wertes haben.

Das zu validierende Feld muss eine Länge zwischen dem angegebenen Minimum und dem Maximum haben.

Bei der zu validierenden Datei muss es sich um ein Bild handeln, das den durch die Parameter der Regel festgelegten Maßbeschränkungen entspricht:

'avatar' => 'dimensions:min_width=100,min_height=200'

Verfügbare Einschränkungen sind: min_width, max_width, min_height, max_height, with, height, ratio (Verhältnis).

Eine Verhältnisbeschränkung sollte als Breite geteilt durch Höhe dargestellt werden. Dies kann entweder durch eine Anweisung wie 3/2 oder einen Float wie 1.5 angegeben werden:

'avatar' => 'dimensions:ratio=3/2'

Da diese Regel mehrere Argumente erfordert, können Sie die Methode Rule::dimensions verwenden, um die Regel flüssig zu konstruieren:

use Illuminate\Validation\Rule;

Validator::make($data, [
    'avatar' => [
        'required',
        Rule::dimensions()->maxWidth(1000)->maxHeight(500)->ratio(3 / 2),
    ],
]);

Beim Arbeiten mit Arrays darf das zu validierende Feld keine doppelten Werte aufweisen.

'foo.*.id' => 'distinct'

Das zu validierende Feld muss als E-Mail-Adresse formatiert sein. Unter der Haube verwendet diese Validierungsregel das Paket egulias/email-validator zur Validierung der E-Mail-Adresse. Standardmäßig wird der RFCValidation-Validator verwendet, aber Sie können auch andere Validierungsstile verwenden:

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

Das obige Beispiel bezieht sich auf die Validierungen RFCValidation und DNSCheckValidation. Hier ist eine vollständige Liste der Validierungsstile, die Sie anwenden können:

• rfc: RFCValidation
• strict: NoRFCWarningsValidation
• dns: DNSCheckValidation
• spoof: SpoofCheckValidation
• filter: FilterEmailValidation

Der filter-Validator, der die filter_var-Funktion von PHP unter der Haube verwendet, wird mit Laravel ausgeliefert und ist Laravels Verhalten vor 5.8.

Das zu validierende Feld muss mit einem der angegebenen Werte enden.

Das zu validierende Feld muss in einer bestimmten Datenbanktabelle vorhanden sein.

Basic Usage Of Exists Rule

'state' => 'exists:states'

Wenn die Spaltenoption (column) nicht angegeben ist, wird der Feldname verwendet.

Specifying A Custom Column Name

'state' => 'exists:states,abbreviation'

Gelegentlich müssen Sie eine bestimmte Datenbankverbindung angeben, die für die vorhandene Abfrage (exist-Query) verwendet werden soll. Sie können dies erreichen, indem Sie dem Tabellennamen den Verbindungsnamen mit der Syntax "dot" voranstellen:

'email' => 'exists:connection.staff,email'

Wenn Sie die von der Validierungsregel ausgeführte Abfrage anpassen möchten, können Sie die Regel mit der Rule-Klasse fließend definieren. In diesem Beispiel werden wir auch die Validierungsregeln als Array angeben, anstatt sie mit dem Zeichen | zu begrenzen:

use Illuminate\Validation\Rule;

Validator::make($data, [
    'email' => [
        'required',
        Rule::exists('staff')->where(function ($query) {
            $query->where('account_id', 1);
        }),
    ],
]);

Das zu validierende Feld muss eine erfolgreich hochgeladene Datei sein.

Das zu validierende Feld darf nicht leer sein, wenn es vorhanden ist.

Das zu validierende Feld muss größer sein als das angegebene Feld. Die beiden Felder müssen vom gleichen Typ sein. Zeichenketten, Zahlen, Arrays und Dateien werden nach den gleichen Konventionen wie die size-Rule ausgewertet.

Das zu validierende Feld muss größer oder gleich dem angegebenen Feld sein. Die beiden Felder müssen vom gleichen Typ sein. Zeichenketten, Zahlen, Arrays und Dateien werden nach den gleichen Konventionen wie die size-Rule ausgewertet.

Die zu validierende Datei muss ein Bild sein (jpeg, png, bmp, gif, gif, svg, oder webp).

Das zu validierende Feld muss in die angegebene Werteliste aufgenommen werden. Da diese Regel oft erfordert, dass Sie ein Array implodieren, kann die Methode Rule::in verwendet werden, um die Regel fließend zu konstruieren:

use Illuminate\Validation\Rule;

Validator::make($data, [
    'zones' => [
        'required',
        Rule::in(['first-zone', 'second-zone']),
    ],
]);

Das zu validierende Feld muss in den Werten eines anderen Feldes vorhanden sein.

Das zu prüfende Feld muss eine ganze Zahl sein.

Das zu validierende Feld muss eine IP-Adresse sein.

Das zu validierende Feld muss eine IPv4-Adresse sein.

Das zu validierende Feld muss eine IPv6-Adresse sein.

Das zu prüfende Feld muss eine gültige JSON-Zeichenkette sein.

Das zu validierende Feld muss kleiner als das angegebene Feld sein. Die beiden Felder müssen vom gleichen Typ sein. Zeichenketten, Zahlen, Arrays und Dateien werden nach den gleichen Konventionen wie die size-Rule ausgewertet.

Das zu validierende Feld muss kleiner oder gleich dem angegebenen Feld sein. Die beiden Felder müssen vom gleichen Typ sein. Zeichenketten, Zahlen, Arrays und Dateien werden nach den gleichen Konventionen wie die size-Rule ausgewertet.

Das zu validierende Feld muss kleiner oder gleich einem Maximalwert sein. Zeichenketten, Zahlen, Arrays und Dateien werden auf die gleiche Weise wie die size-Rule ausgewertet.

Die zu validierende Datei muss mit einem der angegebenen MIME-Typen übereinstimmen:

'video' => 'mimetypes:video/avi,video/mpeg,video/quicktime'

Um den MIME-Typ der hochgeladenen Datei zu bestimmen, wird der Inhalt der Datei gelesen und das Framework versucht, den MIME-Typ zu erraten, der sich von dem vom Client bereitgestellten MIME-Typ unterscheiden kann.

Die zu validierende Datei muss einen MIME-Typ haben, der einer der aufgeführten Erweiterungen entspricht.

Basic Usage Of MIME Rule

'photo' => 'mimes:jpeg,bmp,png'

Auch wenn Sie nur die Erweiterungen angeben müssen, validiert diese Regel tatsächlich gegen den MIME-Typ der Datei, indem sie den Inhalt der Datei liest und ihren MIME-Typ errät.

Eine vollständige Auflistung der MIME-Typen und der dazugehörigen Erweiterungen finden Sie unter folgender Adresse: 

https://svn.apache.org/repos/asf/httpd/httpd/trunk/docs/conf/mime.types

Das zu validierende Feld muss einen Mindestwert haben. Zeichenketten, Zahlen, Arrays und Dateien werden auf die gleiche Weise wie die size-Rule ausgewertet.

Das zu validierende Feld darf nicht in die angegebene Werteliste aufgenommen werden. Die Rule::notIn-Methode kann verwendet werden, um die Regel flüssig zu erstellen:

use Illuminate\Validation\Rule;

Validator::make($data, [
    'toppings' => [
        'required',
        Rule::notIn(['sprinkles', 'cherries']),
    ],
]);

Das zu validierende Feld darf nicht mit dem angegebenen regulären Ausdruck übereinstimmen.

Intern verwendet diese Regel die PHP-Funktion preg_match. Das angegebene Muster sollte der gleichen Formatierung entsprechen, die von preg_match gefordert wird, und daher auch gültige Trennzeichen enthalten. Zum Beispiel:

'email' => 'not_regex:/^.+$/i'

Hinweis: Bei der Verwendung der Muster regex / not_regex kann es notwendig sein, Regeln in einem Array anstelle von Rohrbegrenzern anzugeben, insbesondere wenn der reguläre Ausdruck ein Rohrzeichen enthält.

Das zu validierende Feld kann Null sein. Dies ist besonders nützlich bei der Validierung von Primitiven wie Zeichenketten und ganzen Zahlen, die Nullwerte enthalten können.

Das zu validierende Feld muss numerisch sein.

Das zu validierende Feld muss in den Eingabedaten vorhanden sein, kann aber leer sein.

Das zu validierende Feld darf nicht mit dem angegebenen regulären Ausdruck übereinstimmen.

Intern verwendet diese Regel die PHP-Funktion preg_match. Das angegebene Muster sollte der gleichen Formatierung entsprechen, die von preg_match gefordert wird, und daher auch gültige Trennzeichen enthalten. Zum Beispiel:

'email' => 'not_regex:/^.+$/i'

Hinweis: Bei der Verwendung der Muster regex / not_regex kann es notwendig sein, Regeln in einem Array anstelle von Pipezeichen | anzugeben, insbesondere wenn der reguläre Ausdruck ein Pipezeichen | enthält.

Das zu validierende Feld muss in den Eingabedaten vorhanden und nicht leer sein. Ein Feld gilt als "leer", wenn eine der folgenden Bedingungen erfüllt ist:

• Der Wert ist Null.
• Der Wert ist eine leere Zeichenkette.
• Der Wert ist ein leeres Array oder ein leeres Countable-Objekt.
• Der Wert ist eine hochgeladene Datei ohne Pfad.

Das zu validierende Feld muss vorhanden und nicht leer sein, wenn das Feld eines anderen Feldes gleich einem beliebigen Wert ist.

Wenn Sie eine komplexere Bedingung für die required_if-Regel konstruieren möchten, können Sie die Methode Rule::requiredIf verwenden. Diese Methode akzeptiert ein boolesches oder ein Closure. Wenn ein Abschluss übergeben wird, sollte der Abschluss true oder false zurückgeben, um anzugeben, ob das zu validierende Feld erforderlich ist:

use Illuminate\Validation\Rule;

Validator::make($request->all(), [
    'role_id' => Rule::requiredIf($request->user()->is_admin),
]);

Validator::make($request->all(), [
    'role_id' => Rule::requiredIf(function () use ($request) {
        return $request->user()->is_admin;
    }),
]);

Das zu prüfende Feld muss vorhanden und nicht leer sein, es sei denn, das andere Feld ist gleich einem Wert.

Das zu validierende Feld muss vorhanden sein und darf nicht leer sein, nur wenn eines der anderen angegebenen Felder vorhanden ist.

Das zu validierende Feld muss vorhanden und nicht leer sein, nur wenn alle anderen angegebenen Felder vorhanden sind.

Das zu validierende Feld muss vorhanden und nicht leer sein, nur wenn keines der anderen angegebenen Felder vorhanden ist.

Das zu validierende Feld muss vorhanden und nicht leer sein, nur wenn alle anderen angegebenen Felder nicht vorhanden sind.

Das angegebene Feld muss mit dem Feld unter Validierung übereinstimmen.

Das zu prüfende Feld muss eine Größe haben, die dem angegebenen Wert entspricht. Bei Zeichenkettendaten entspricht der Wert der Anzahl der Zeichen. Bei numerischen Daten entspricht der Wert einem gegebenen ganzzahligen Wert. Bei einem Array entspricht die Größe der Anzahl (Count) der Arrays. Bei Dateien entspricht die Größe der Dateigröße in Kilobyte.

Das zu validierende Feld muss mit einem der angegebenen Werte beginnen.

Das zu prüfende Feld muss eine Zeichenkette sein. Wenn Sie zulassen möchten, dass das Feld auch Null ist, sollten Sie dem Feld die nullable-Rule zuordnen.

Das zu prüfende Feld muss ein gültiger Zeitzonenbezeichner gemäß der PHP-Funktion timezone_identifiers_list sein.

Das zu validierende Feld darf in der angegebenen Datenbanktabelle nicht vorhanden sein.

Specifying A Custom Column Name:

Die column-Option kann verwendet werden, um die entsprechende Datenbankspalte des Feldes anzugeben. Wenn die column-Option nicht angegeben ist, wird der Feldname verwendet.

'email' => 'unique:users,email_address'

Forcing A Unique Rule To Ignore A Given ID:

Manchmal möchten Sie eine bestimmte ID während der eindeutigen Prüfung ignorieren. Betrachten Sie beispielsweise einen Bildschirm "Aktualisierungsprofil", der den Namen, die E-Mail-Adresse und den Standort des Benutzers enthält. Sie werden wahrscheinlich überprüfen wollen, ob die E-Mail-Adresse eindeutig ist. Wenn der Benutzer jedoch nur das Namensfeld und nicht das E-Mail-Feld ändert, soll kein Validierungsfehler ausgegeben werden, da der Benutzer bereits Eigentümer der E-Mail-Adresse ist.

Um den Prüfer anzuweisen, die ID des Benutzers zu ignorieren, verwenden wir die Klasse Rule, um die Regel fließend zu definieren. In diesem Beispiel werden wir auch die Validierungsregeln als Array angeben, anstatt das Zeichen | zum Begrenzen der Regeln zu verwenden:

use Illuminate\Validation\Rule;

Validator::make($data, [
    'email' => [
        'required',
        Rule::unique('users')->ignore($user->id),
    ],
]);

Anstatt den Wert des Modellschlüssels an die ignore-Methode zu übergeben, können Sie die gesamte Modellinstanz übergeben. Laravel extrahiert automatisch den Schlüssel aus dem Modell:

Rule::unique('users')->ignore($user)

Wenn Ihre Tabelle einen anderen Spaltennamen für den Primärschlüssel als id verwendet, können Sie den Namen der Spalte beim Aufruf der ignore-Methode angeben:

Rule::unique('users')->ignore($user->id, 'user_id')

Standardmäßig überprüft die unique-Rule die Eindeutigkeit der Spalte, die dem Namen des zu validierenden Attributs entspricht. Sie können jedoch einen anderen Spaltennamen als zweites Argument an die unique-Methode übergeben:

Rule::unique('users', 'email_address')->ignore($user->id)

Adding Additional Where Clauses:

Sie können auch zusätzliche Abfrageeinschränkungen angeben, indem Sie die Abfrage mit der where-Methode anpassen. Fügen wir zum Beispiel eine Einschränkung hinzu, die bestätigt, dass die account_id 1 ist:

'email' => Rule::unique('users')->where(function ($query) {
    return $query->where('account_id', 1);
})

Das zu validierende Feld muss eine gültige URL sein.

Das zu prüfende Feld muss ein gültiger RFC 4122 (Version 1, 3, 4 oder 5) Universal Unique Identifier (UUID) sein.