Validieren, falls vorhanden

In einigen Fällen können Validierungsprüfungen nur für ein Feld durchgeführt werden, wenn im Array vorhanden ist. Dies kann durch Hinzufügen von sometimes zur Regelliste erreicht werden:

$v = Validator::make($data, [    'email' => 'sometimes|required|email',]);

Im obigen Beispiel wird das Feld email nur validiert, wenn es im Array $data vorhanden ist.

{Tipp} Wenn Sie versuchen, ein Feld zu validieren, das immer vorhanden sein sollte, aber möglicherweise leer ist, lesen Sie bitte die Hinweise zu optionalen Feldern

Komplexe bedingte Validierung

Manchmal müssen Sie möglicherweise Validierungsregeln hinzufügen, die auf einer komplexeren bedingten Logik basieren. Beispielsweise möchten Sie möglicherweise, dass ein bestimmtes Feld nur dann erforderlich ist, wenn der Wert eines anderen Felds 100 überschreitet. Oder wenn ein bestimmtes Feld vorhanden ist, können die anderen beiden Felder den angegebenen Wert haben. Das Hinzufügen solcher Überprüfungsbedingungen ist nicht schwierig. Erstellen Sie zunächst eine Instanz von Validator mithilfe einer statischen Regel:

$v = Validator::make($data, [  
  'email' => 'required|email',    
  'games' => 'required|numeric',
]);

Nehmen wir an, wir haben eine Webanwendung, die für Spielesammler entwickelt wurde. Wenn ein Spielesammler mehr als hundert Spiele besitzt, möchten wir ihn bitten, zu erklären, warum er so viele Spiele besitzt. Sie könnten beispielsweise einen Spielevertrieb betreiben oder einfach nur Spaß am Sammeln haben. Um diese Validierungsanforderung unter bestimmten Bedingungen hinzuzufügen, können Sie die Validator-Methode für die sometimes-Instanz verwenden.

$v->sometimes('reason', 'required|max:500', function ($input) {  
  return $input->games >= 100;
});

Der erste Parameter, der an die sometimes-Methode übergeben wird, ist der Feldname, der für die Validierung verwendet werden soll. Der zweite Parameter ist die Validierungsregel, die wir verwenden möchten. 闭包 wird als dritter Parameter übergeben. Wenn true zurückgegeben wird, werden zusätzliche Regeln hinzugefügt. Mit dieser Methode ist es einfach, komplexe bedingte Validierungen zu erstellen. Sie können sogar mehreren Feldern gleichzeitig eine bedingte Validierung hinzufügen:

$v->sometimes(['reason', 'cost'], 'required', function ($input) {   
   return $input->games >= 100;
 });

{tip} Das an 闭包 übergebene Argument $input ist eine Instanz von IlluminateSupportFluent und kann für den Zugriff auf Ihre Eingabe verwendet werden oder Dateiobjekt.

Arrays validieren

Es ist nicht schwierig, Felder zu validieren, bei denen die Eingabe des Formulars eine ist Array. Sie können die „Punkt“-Methode verwenden, um Eigenschaften in einem Array zu validieren. Wenn die eingehende HTTP-Anfrage beispielsweise das Feld photos[profile] enthält, kann es wie folgt überprüft werden:

$validator = Validator::make($request->all(), [  
  'photos.profile' => 'required|image',
]);

Sie können auch jedes Element im Array überprüfen. Um beispielsweise zu überprüfen, ob jede E-Mail im angegebenen Array-Eingabefeld eindeutig ist, können Sie Folgendes tun:

$validator = Validator::make($request->all(), [  
  'person.*.email' => 'email|unique:users',    
  'person.*.first_name' => 'required_with:person.*.last_name',
]);

Ebenso können Sie * verwenden, wenn Sie Verifizierungsinformationen in der Sprachdatei definieren Zeichen verwenden Sie eine einzelne Validierungsnachricht für Array-basierte Felder:

'custom' => [  
  'person.*.email' => [    
      'unique' => 'Each person must have a unique e-mail address',   
     ]
    ],

Benutzerdefinierte Validierungsregel

Verwendung von Regelobjekten

Laravel bietet viele nützliche Validierungsregeln und unterstützt auch benutzerdefinierte Regeln. Eine Möglichkeit, benutzerdefinierte Validierungsregeln zu registrieren, ist die Verwendung eines Regelobjekts. Neue Regelobjekte können mit dem Artisan-Befehl make:rule generiert werden. Als Nächstes verwenden wir diesen Befehl, um eine Regel zu generieren, die überprüft, ob eine Zeichenfolge in Großbuchstaben geschrieben ist. Laravel speichert neue Regeln im Verzeichnis app/Rules:

php artisan make:rule Uppercase

Sobald die Regel erstellt ist, können wir ihr Verhalten definieren. Das Regelobjekt enthält zwei Methoden: passes und message. Die passes-Methode empfängt den Attributwert und -namen und gibt true oder false zurück, je nachdem, ob der Attributwert den Regeln entspricht. Die message-Methode sollte die Validierungsfehlermeldung zurückgeben, die verwendet werden soll, wenn die Validierung fehlschlägt:

<?php
  namespace App\Rules;
  use Illuminate\Contracts\Validation\Rule;
  class Uppercase implements Rule{   
        /**
     * 判断验证规则是否通过。
     *
     * @param  string  $attribute
     * @param  mixed  $value
     * @return bool
     */   
    public function passes($attribute, $value)   
     {       
       return strtoupper($value) === $value;   
      }   
     /**
     * 获取验证错误消息。
     *
     * @return string
     */   
    public function message()  
      {       
       return 'The :attribute must be uppercase.';   
       }
      }

Wenn Sie natürlich eine Fehlermeldung aus der Übersetzungsdatei zurückgeben möchten, können Sie die Hilfsfunktion über aufrufen message Methode trans:

/**
 * 获取验证错误消息。
 *
 * @return string
 */
 public function message(){  
   return trans('validation.uppercase');
  }

Sobald das Regelobjekt definiert ist, können Sie eine Instanz des Regelobjekts zusammen mit anderen Validierungsregeln an den Validator übergeben:

use App\Rules\Uppercase;$request->validate([  
  'name' => ['required', 'string', new Uppercase],
]);

Abschlüsse verwenden

Wenn Sie die Funktionalität benutzerdefinierter Regeln nur einmal in Ihrer Anwendung benötigen, können Sie stattdessen Abschlüsse verwenden. Keine Regel Objekt. Der Abschluss erhält den Namen des Attributs, dessen Wert bei fehlgeschlagener Validierung $fail im Callback verwendet werden soll:

$validator = Validator::make($request->all(), [   
 'title' => [      
   'required',        
   'max:255',        
   function ($attribute, $value, $fail) {          
     if ($value === 'foo') {              
       $fail($attribute.' is invalid.');      
             }      
            },    
          ],
        ]);

Verwenden der Erweiterung

Eine andere Möglichkeit, benutzerdefinierte Validierungsregeln zu registrieren, ist die Verwendung der Validator-Fassade extend Methode. Verwenden wir diese Methode, um benutzerdefinierte Validierungsregeln im Service-Container zu registrieren:

<?php
  namespace App\Providers;
  use Illuminate\Support\ServiceProvider;
  use Illuminate\Support\Facades\Validator;
  class AppServiceProvider extends ServiceProvider{   
      /**
     * 引导任何应用程序。
     *
     * @return void
     */   
  public function boot()   
   {       
     Validator::extend('foo', function ($attribute, $value, $parameters, $validator) { 
        return $value == 'foo';  
         });   
       }    
     /**
     * 注册服务提供器。
     *
     * @return void
     */   
     public function register()   
      {       
       //   
       }
     }

Der benutzerdefinierte Validierungsabschluss erhält vier Parameter: den Namen des zu überprüfenden Attributs $attribute, den Wert des Attributs $value , das an die Validierungsregel übergebene Parameterarray $parameters und die tatsächliche Spalte Validator.

Neben der Verwendung von Abschlüssen können Sie auch Klassen und Methoden an die extend-Methode übergeben:

Validator::extend('foo', 'FooValidator@validate');

Fehlermeldungen definieren

Sie auch Für benutzerdefinierte Regeln müssen Fehlermeldungen definiert werden. Sie können diese Funktionalität erreichen, indem Sie ein benutzerdefiniertes Inline-Nachrichtenarray verwenden oder einen Eintrag in der Validierungssprachendatei hinzufügen. Die Nachricht sollte an erster Stelle im Array platziert werden, nicht im Array custom, das nur zum Speichern attributspezifischer Fehlermeldungen verwendet wird:

"foo" => "Your input was invalid!",
"accepted" => "The :attribute must be accepted.",
// 其余的验证错误消息...

Beim Erstellen einer benutzerdefinierten Validierungsregel müssen Sie möglicherweise manchmal benutzerdefinierte Platzhalter definieren für Fehlermeldungen. Dies kann durch Erstellen eines benutzerdefinierten Validators und anschließenden Aufruf der Validator-Methode an der replacer-Fassade erfolgen. Sie können die folgenden Vorgänge in der boot-Methode des Service-Containers ausführen:

/**
 * 启动应用程序。
 *
 * @return void
 */
 public function boot(){  
   Validator::extend(...);    
   Validator::replacer('foo', function ($message, $attribute, $rule, $parameters) {    
       return str_replace(...);  
      });
 }

Implizite Erweiterung

Wenn das zu überprüfende Attribut nicht vorhanden ist oder einen durch die required-Regel definierten Nullwert enthält, gelten standardmäßig die normalen Validierungsregeln, einschließlich self The Definitionserweiterung wird nicht ausgeführt. Beispielsweise validiert die unique-Regel den null-Wert nicht:

$rules = ['name' => 'unique'];
$input = ['name' => null];
Validator::make($input, $rules)->passes();
 // true

Wenn Sie verlangen, dass eine Eigenschaft validiert wird, auch wenn sie leer ist, müssen Sie implizieren, dass die Eigenschaft ist erforderlich. Um eine solche „implizite“ Erweiterung zu erstellen, verwenden Sie die Methode Validator::extendImplicit():

Validator::extendImplicit('foo', function ($attribute, $value, $parameters, $validator) { 
   return $value == 'foo';
  });

{note} Eine „implizite“ Erweiterung impliziert nur, dass die Eigenschaft erforderlich ist. Ob es fehlt oder null ist, liegt bei Ihnen.