• クイック検証
• ##ルーティングの定義
  • ルーターの作成
  • #検証ロジックの作成
  ##検証エラー メッセージの表示
  • #オプションのフィールド ノート
  • 検証フォーム リクエスト
  フォーム リクエスト検証の作成
• フォーム リクエスト承認の検証
  • カスタム検証エラー メッセージ
  • カスタム検証属性
  • バリデーターを手動で作成する
  自動リダイレクト
• 間違ったパッケージに名前を付ける
  • 検証後フック
  エラー メッセージの処理
  カスタマイズ検証エラー メッセージ
• 利用可能な検証ルール
  条件による検証ルールの追加
• 検証配列
• カスタム検証ルール
• 検証ルール オブジェクトを使用する
• クロージャを使用する
  • 拡張機能を使用する
  ##はじめに

ValidatesRequests トレイトを使用します。これは、さまざまな強力な検証ルールを使用して受信 HTTP リクエストを検証する便利な方法を提供します。

クイック検証

Laravel の強力な検証機能を理解するために、フォームを検証してユーザーにエラー メッセージを表示する完全な例を見てみましょう。

ルートの定義

まず、routes/web.php## で次のように仮定します。 # file 次のルートは次の場所で定義されています:

Route::get('post/create', 'PostController@create');
Route::post('post', 'PostController@store');

GET ルートはユーザーが新しいブログ投稿を作成するためのフォームを表示し、POST ルートは新しいブログを保存します。データベースの真ん中に投稿します。

ストア ## を見てみましょう。 # ここではメソッドを空白のままにしておきます。

<?php
  namespace App\Http\Controllers;
  use Illuminate\Http\Request;
  use App\Http\Controllers\Controller;
  class PostController extends Controller{    
      /**
     * 显示创建博客文章的表单。
     *
     * @return Response
     */   
  public function create()   
   {       
    return view('post.create');    
    }   
     /**
     * 保存一篇新的博客文章。
     *
     * @param  Request  $request
     * @return Response
     */   
    public function store(Request $request)   
     {      
       // 验证并存储博客文章...   
      }
   }

次に、

でロジックの作成を開始します。新しいブログ投稿を確認する方法。これを行うには、Illuminate\Http\Request オブジェクトによって提供される validate メソッドを使用します。検証に合格すると、コードは正常に実行できます。検証が失敗した場合、例外がスローされ、対応するエラー応答が自動的にユーザーに返されます。一般的な HTTP リクエストの場合はリダイレクト応答が生成されますが、AJAX リクエストの場合は JSON 応答が送信されます。

メソッドに戻り、validate メソッドを詳しく理解しましょう:

/**
 * 保存一篇新的博客文章。
 *
 * @param  Request  $request
 * @return Response
 */
 public function store(Request $request){ 
    $validatedData = $request->validate([      
      'title' => 'required|unique:posts|max:255',        
      'body' => 'required',    
    ]);    
    // 博客文章验证通过
  }

メソッドに渡されます。また、もう一度検証が失敗した場合、対応する応答が自動的に生成されます。検証に合格した場合、コントローラーは引き続き正常に動作します。

プロパティが初めて検証に失敗した後に検証ルールの実行を停止する場合は、## を追加する必要があります。 #bail

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

unique ルールを通過しない場合、プログラムは続行されません。 max ルールを確認します。ルールは割り当てられた順序で検証されます。

$request->validate([   
 'title' => 'required|unique:posts|max:255',    
 'author.name' => 'required',    
 'author.description' => 'required',
]);

検証エラー メッセージを表示する

受信リクエスト パラメータが指定された検証ルールを通過しない場合はどうなりますか?前述したように、Laravel はユーザーを前の場所に自動的にリダイレクトします。さらに、すべての検証エラー メッセージは session に自動的に保存されます。

もう一度言いますが、GET ルート内のビューにエラー メッセージを明示的にバインドする必要はありません。 Lavarel はセッション データ内のエラー情報をチェックし、それを自動的にビューにバインドします (ビュー ファイルが存在する場合)。変数 $errors は、Illuminate\Support\MessageBag のインスタンスです。このオブジェクトの詳細については、このドキュメントを参照してください。

{ヒント} $errors 変数は、Web によって提供される Illuminate\View\Middleware\ShareErrorsFromSession ミドルウェアによってバインドされます。ミドルウェア グループが表示されます。 このミドルウェアが適用されると、$error 変数 がビューで取得され、常に $errors 変数が存在し安全であると想定できます。使用。

上記の例では、検証が失敗すると、ユーザーはコントローラーの create メソッドにリダイレクトされ、ビューにエラー メッセージ

<!-- /resources/views/post/create.blade.php -->
<h1>创建文章</h1>
@if ($errors->any())  
  <div class="alert alert-danger">     
     <ul>
       @foreach ($errors->all() as $error)                
       <li>{{ $error }}</li>
            @endforeach
      </ul>    
   </div>
 @endif
 <!-- 创建文章表单 -->

オプション フィールドに関する注意事項

デフォルトでは、Laravel アプリケーションのグローバル ミドルウェア スタック内の App\Http\ Kernel クラスには、TrimStrings および ConvertEmptyStringsToNull ミドルウェアが含まれています。したがって、バリデーターで null 値を無効として扱いたくない場合は、「オプション」リクエスト フィールドを nullable としてマークする必要があります。たとえば、

$request->validate([  
  'title' => 'required|unique:posts|max:255',    
  'body' => 'required',    
  'publish_at' => 'nullable|date',
]);

この例では、publish_at フィールドを null または有効な日付形式にできることを指定します。 nullable 修飾子がルール定義に追加されていない場合、バリデーターは null を無効な日付形式とみなします。

validate メソッドを使用すると、Laravel はリダイレクト応答を生成せず、代わりにすべての検証エラー情報を含む JSON 応答を生成します。この JSON 応答は、HTTP ステータス コード 422 とともに送信されます。

フォーム リクエスト検証の作成

より複雑な検証シナリオに直面して、より複雑なロジックを処理するための「フォーム リクエスト」を作成できます。フォームリクエストは、検証ロジックを含むカスタムリクエストクラスです。アーティザン コマンド make:request を使用して、フォーム リクエスト クラスを作成できます。

php artisan make:request StoreBlogPost

新しく生成されたクラスは、app/Http/Requests ディレクトリに保存されます。このディレクトリが存在しない場合は、make:request コマンドの実行時に作成されます。 rules メソッドにいくつかの検証ルールを追加しましょう:

/**
 * 获取适用于请求的验证规则。
 *
 * @return array
 */
 public function rules(){   
  return [       
    'title' => 'required|unique:posts|max:255',        
    'body' => 'required',    
    ];
  }

{tip} 任意の依存関係を rules メソッドに渡すことができます。これらはLaravelが提供するサービスコンテナによって自動的に解決されます。

検証ルールはどのように機能しますか?必要なのは、コントローラー メソッドで受信リクエストをタイプヒントすることだけです。コントローラー メソッドを呼び出す前に、受信したフォーム リクエストを検証します。つまり、コントローラーに検証ロジックを記述する必要はありません。

/**
 * 存储传入的博客文章。
 *
 * @param  StoreBlogPost  $request
 * @return Response
 */
 public function store(StoreBlogPost $request){   
  // 传入的请求通过验证...    
  // 获取通过验证的数据...    
  $validated = $request->validated();
 }

検証が失敗した場合は、ユーザーを前の状態に戻すメッセージが生成されます。ロケーションリダイレクト応答。これらのエラーは session にもフラッシュされ、ページ上に表示できるようになります。受信リクエストが AJAX の場合、422 ステータス コードと検証エラー情報を含む JSON データの HTTP 応答がユーザーに返されます。

フォーム リクエストの後にフックを追加する

フォーム リクエストの「後」にフックを追加する場合は、withValidator を使用できます。方法。このメソッドは完全な検証コンストラクターを受け入れるため、検証結果が返される前に任意のメソッドを呼び出すことができます:

/**
 *  配置验证器实例。
 *
 * @param  \Illuminate\Validation\Validator  $validator
 * @return void
 */
 public function withValidator($validator){ 
    $validator->after(function ($validator) {        
         if ($this->somethingElseIsInvalid()) {           
              $validator->errors()->add('field', 'Something is wrong with this field!');        
             }   
         });
   }

フォーム リクエストの承認検証

フォームリクエストクラスには、authorizeメソッドも含まれています。このメソッドでは、認証されたユーザーをチェックして、指定されたリソースを更新する権限があるかどうかを判断できます。たとえば、ユーザーが記事のコメントを更新する権限を持っているかどうかを判断できます。

/**
 * 判断用户是否有权限做出此请求。
 *
 * @return bool
 */
 public function authorize(){  
   $comment = Comment::find($this->route('comment'));    
   return $comment && $this->user()->can('update', $comment);
 }

すべてのフォームリクエストは Laravel のリクエスト基本クラスを継承するため、user メソッドを使用できます。現在認証されているログインユーザー。上記の例の route メソッドの呼び出しにも注意してください。このメソッドを使用すると、呼び出されるルートで定義されている URI パラメータ (次の例の {comment} パラメータなど) を取得できます。メソッドが

を返すと、403 ステータス コードを含む HTTP 応答が自動的に返され、コントローラー メソッドは実行されません。 アプリケーションの他の部分で認可ロジックを処理する予定がある場合は、authorize メソッドから

を返すだけです:

Route::post('comment/{comment}');

エラー メッセージのカスタマイズ

フォーム リクエストの messages メソッドをオーバーライドすることで、エラー メッセージをカスタマイズできます。このメソッドは、プロパティ/ルールのペアの配列と、それに対応するエラー メッセージを返す必要があります:

/**
 * 判断用户是否有权限进行此请求。
 *
 * @return bool
 */
 public function authorize(){  
   return true;
  }

:attribute 部分をカスタム属性名に置き換える場合は、attributes メソッドをオーバーライドしてカスタム名を指定できます。このメソッドは、プロパティと名前のペアの配列を返す必要があります:

/**
 * 获取已定义验证规则的错误消息。
 *
 * @return array
 */
 public function messages(){  
   return [       
    'title.required' => 'A title is required',        
    'body.required'  => 'A message is required',    
    ];
  }

validate メソッドを使用すると、Validator ファサードを介してバリデーターのサンプルを手動で作成できます。
Validator ファサードで make メソッドを使用してバリデーターの例を作成します:

/**
 * 获取验证错误的自定义属性。
 *
 * @return array
 */
 public function attributes(){  
   return [      
     'email' => 'email address',    
     ];
   }

make メソッドに渡される最初のパラメーターは次のとおりです。検証が必要なデータ。 2 番目のパラメーターは、データの検証ルールです。

withErrors メソッドを使用してエラー メッセージをセッションにフラッシュできます。このメソッドをリダイレクトに使用すると、$errors 変数がビューと自動的に共有され、これらのメッセージをユーザーに表示できるようになります。 withErrors メソッドは、バリデータ、MessageBag または PHP Array を受け取ります。

validates# を使用する場合## メソッドは自動リダイレクトを提供します。その後、既存のバリデーターの例で validate メソッドを呼び出すことができます。検証が失敗した場合、ユーザーは自動的にリダイレクトされます。 AJAX リクエストでは、JSON 形式のレスポンスが返されます。

<?php
   namespace App\Http\Controllers;use Validator;
   use Illuminate\Http\Request;
   use App\Http\Controllers\Controller;
   class PostController extends Controller{    
      /**
     * 保存一篇新的博客文章。
     *
     * @param  Request  $request
     * @return Response
     */   
    public function store(Request $request)   
     {       
      $validator = Validator::make($request->all(), [      
            'title' => 'required|unique:posts|max:255',            
            'body' => 'required',        
          ]);       
        if ($validator->fails()) {          
          return redirect('post/create')                       
           ->withErrors($validator)                        
           ->withInput();       
           }       
       // Store the blog post...  
        }
      }

ページ上に複数のフォームがある場合は、次のようにしてエラー パッケージに名前を付けることができます。特定のフォームのエラー メッセージを取得します。

メソッド

Validator::make($request->all(), [   
 'title' => 'required|unique:posts|max:255',    
 'body' => 'required',
])->validate();

変数から取得できます。 # #

return redirect('register')          
  ->withErrors($validator, 'login');

after

{{ $errors->login->first('email') }}

エラー メッセージの処理

Validator インスタンスで errors メソッドを呼び出した後、Illuminate\Support\MessageBag インスタンスを取得します。 , エラーメッセージを処理するためのさまざまな便利な方法が用意されています。 $errors 変数はすべてのビューに自動的に提供され、MessageBag クラスのインスタンスでもあります。

特定のフィールドの最初のエラー メッセージを表示する

特定のフィールドの最初のエラー メッセージを表示するには、first メソッドを使用します。 :

$validator = Validator::make(...);$validator->after(function ($validator) {   
 if ($this->somethingElseIsInvalid()) {     
    $validator->errors()->add('field', 'Something is wrong with this field!');   
     }
   });
 if ($validator->fails()) {  
   //
 }

特定のフィールドのすべてのエラー メッセージを表示

指定したフィールドのすべてのエラー メッセージの配列を取得する必要がある場合は、get メソッド:

$errors = $validator->errors();echo $errors->first('email');

フォームの配列フィールドを検証する場合は、# を使用して各配列要素のすべてのエラー メッセージを取得できます:

foreach ($errors->get('email') as $message) {  
  //
}

すべてのフィールドのすべてのエラー メッセージを表示

すべてのフィールドのすべてのエラー メッセージを取得したい場合は、all メソッドを使用できます。

foreach ($errors->get('attachments.*') as $message) { 
   //
}

has メソッドを使用して、指定されたフィールドにエラー メッセージが含まれているかどうかを判断できます:

foreach ($errors->all() as $message) { 
   //
}

Validator::make メソッドに渡すことができます。

if ($errors->has('email')) { 
   //
}

:attribute プレースホルダーが置き換えられます。検証フィールドの実際の名前によって。さらに、検証メッセージで他のプレースホルダーを使用することもできます。例:

$messages = [  
  'required' => 'The :attribute field is required.',
 ];
 $validator = Validator::make($input, $rules, $messages);

$messages = [   
 'same'=> 'The :attribute and :other must match.',    
 'size'=> 'The :attribute must be exactly :size.',    
 'between' => 'The :attribute value :input is not between :min - :max.',    
 'in'=> 'The :attribute must be one of the following types: :values',
];

Validator に直接渡すのではなく、言語ファイルで指定することになるでしょう。これを行うには、resources/lang/xx/validation.php 言語ファイルの custom 配列にメッセージを配置します。

$messages = [ 
   'email.required' => 'We need to know your e-mail address!',
 ];

:attribute プレースホルダーをカスタム属性名に置き換える場合resources/lang/xx/validation.php 言語ファイルの attributes 配列でカスタム名を指定できます:

'custom' => [  
  'email' => [    
      'required' => 'We need to know your e-mail address!',  
      ],
    ],

'attributes' => [  
  'email' => 'email address',
 ],

$request->validate([  
  'credit_card_number' => 'required_if:payment_type,cc'
 ]);

    当payment type为cc时，credit card number 不能为空。

'values' => [ 
   'payment_type' => [    
       'cc' => '信用卡' 
        ],
    ],

    当payment type 为信用卡时，credit card number不能为空。

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

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

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

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

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

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

'state' => 'exists:states'

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

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

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

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

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

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

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;   
      }),
    ]);

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

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

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

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

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

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

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

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

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

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

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

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

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

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

php artisan make:rule Uppercase

<?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.';   
       }
      }

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

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

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

<?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()   
      {       
       //   
       }
     }

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

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

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