表单验证
简介
Laravel 提供了几种不同的方法来验证传入应用程序的数据。默认情况下,Laravel 的控制器基类使用 ValidatesRequests Trait,它提供了一种方便的方法去使用各种强大的验证规则来验证传入的 HTTP 请求。
快速验证
要了解 Laravel 强大的验证功能,让我们看一个验证表单并将错误消息显示回给用户的完整示例。
定义路由
首先,让我们假设在 routes/web.php 文件中定义了下面这些路由:
Route::get('post/create', 'PostController@create');
Route::post('post', 'PostController@store');显然,GET 路由会显示一个供用户创建一个新的博客帖子的表单,而 POST 路由会将新的博客文章存储在数据库中。
创建路由器
下面让我们一起来看看处理这些路由的控制器, store 方法暂时留空。
编写验证器逻辑
现在我们开始在
store方法中编写逻辑来验证新的博客文章。为此,我们将使用Illuminate\Http\Request对象提供的validate方法 。如果验证通过,代码就可以正常的运行。如果验证失败,则会抛出异常,并自动将对应的错误响应返回给用户。在典型的 HTTP 请求的情况下,会生成一个重定向响应,而对于 AJAX 请求则会发送 JSON 响应。让我们接着回到
store方法来深入理解validate方法:/** * 保存一篇新的博客文章。 * * @param Request $request * @return Response */ public function store(Request $request){ $validatedData = $request->validate([ 'title' => 'required|unique:posts|max:255', 'body' => 'required', ]); // 博客文章验证通过 }如你所见,我们将所需的验证规则传递至
validate方法中。另外再提醒一次,如果验证失败,会自动生成一个对应的响应。如果验证通过,那我们的控制器将会继续正常运行。首次验证失败后停止运行
如果你希望在某个属性第一次验证失败后停止运行验证规则,你需要附加
bail规则到该属性:$request->validate([ 'title' => 'bail|required|unique:posts|max:255', 'body' => 'required', ]);在这个例子中,如果
title字段没有通过unique规则,那么程序就不会继续检查max规则。规则会按照分配的顺序来验证。关于数组数据的注意实现
如果你的 HTTP 请求包含一个 「嵌套」 参数(即数组),那你可以在验证规则中通过 「点」 语法来指定这些参数。
$request->validate([ 'title' => 'required|unique:posts|max:255', 'author.name' => 'required', 'author.description' => 'required', ]);显示验证错误信息
如果传入的请求参数未通过给定的验证规则呢?正如前面所提到的,Laravel 会自动把用户重定向到之前的位置。另外,所有的验证错误信息会被自动 存储到
session中。重申一次,我们不必在
GET路由中将错误消息显式绑定到视图。因为 Lavarel 会检查在 Session 数据中的错误信息,并自动将其绑定到视图(如果这个视图文件存在)。而其中的变量$errors是Illuminate\Support\MessageBag的一个实例。要获取关于这个对象的更多信息,请 查阅这个文档 。{tip}
$errors变量被Web中间件组提供的Illuminate\View\Middleware\ShareErrorsFromSession中间件绑定到视图中。 当这个中间件被应用后,在你的视图中就可以获取到$error变量 , 可以使一直假定$errors变量存在并且可以安全地使用。在上面的例子中,当验证失败的时候,用户将会被重定向到控制器的
create方法,使我们能在视图中显示错误信息:创建文章
@if ($errors->any())@endif@foreach ($errors->all() as $error)
- {{ $error }}
@endforeach关于可选字段的注意事项
默认情况下,在 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是一个无效的日期格式。AJAX 请求 & 验证
在这个例子中,我们使用传统的表单将数据发送到应用程序。但实际情况中,很多程序都会使用 AJAX 来发送请求。当我们对 AJAX 的请求中使用
validate方法时,Laravel 并不会生成一个重定向响应,而是会生成一个包含所有验证错误信息的 JSON 响应。这个 JSON 响应会包含一个 HTTP 状态码 422 被发送出去。验证表单请求
创建表单请求验证
面对更复杂的验证情境中,你可以创建一个「表单请求」来处理更为复杂的逻辑。表单请求是包含验证逻辑的自定义请求类。可使用 Artisan 命令
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}参数:Route::post('comment/{comment}');如果
authorize方法返回false,则会自动返回一个包含 403 状态码的 HTTP 响应,也不会运行控制器的方法。如果你打算在应用程序的其它部分处理授权逻辑,只需从
authorize方法返回true:/** * 判断用户是否有权限进行此请求。 * * @return bool */ public function authorize(){ return true; }{tip} 你可以向
authorize方法传入所需的任何依赖项。他们会自动被 Laravel 提供的 服务容器 自动解析。自定义错误消息
你可以通过重写表单请求的
messages方法来自定义错误消息。此方法应返回属性 / 规则对数组及其对应错误消息:/** * 获取已定义验证规则的错误消息。 * * @return array */ public function messages(){ return [ 'title.required' => 'A title is required', 'body.required' => 'A message is required', ]; }自定义验证属性
如果你希望将验证消息的
:attribute部分替换为自定义属性名称,则可以重写attributes方法来指定自定义名称。此方法应返回属性 / 名称对的数组:/** * 获取验证错误的自定义属性。 * * @return array */ public function attributes(){ return [ 'email' => 'email address', ]; }手动创建验证器
如果你不想在请求上使用
validate方法,你可以通过Validatorfacade 手动创建一个验证器示例。
用Validatorfacade 上的make方法创建一个验证器示例:all(), [ 'title' => 'required|unique:posts|max:255', 'body' => 'required', ]); if ($validator->fails()) { return redirect('post/create') ->withErrors($validator) ->withInput(); } // Store the blog post... } }传给
make方法的第一个参数是需要验证的数据。第二个参数则是该数据的验证规则。如果验证失败,则可以使用
withErrors方法把错误消息闪存到 Session 。使用这个方法进行重定向后,$errors变量会自动和视图共享,你可以把这些消息显示给用户。withErrors方法接收验证器、MessageBag或 PHPArray。自动重定向
如果你想手动创建验证器实例,又想使用
validates方法提供的自动重定向,那么你可以在现有的验证器示例上调用validate方法。如果验证失败,用户将会自动重定向。在 AJAX 请求中,则会返回 JSON 格式的响应。Validator::make($request->all(), [ 'title' => 'required|unique:posts|max:255', 'body' => 'required', ])->validate();命名错误包
如果你一个页面中有多个表单,你可以通过命名错误包来检索特定表单的错误消息。只需给
withErrors方法传递一个名字作为第二个参数return redirect('register') ->withErrors($validator, 'login');然后你就可以从
$errors变量中获取指定表单的错误消息:{{ $errors->login->first('email') }}验证后钩子
验证器还允许你添加在验证成功之后允许的回调函数,以便你进行下一步的验证,甚至在消息集合中添加更多的错误消息。使用它只需在验证实例上使用
after方法:$validator = Validator::make(...);$validator->after(function ($validator) { if ($this->somethingElseIsInvalid()) { $validator->errors()->add('field', 'Something is wrong with this field!'); } }); if ($validator->fails()) { // }处理错误消息
在
Validator实例上调用errors方法后,你会得到一个Illuminate\Support\MessageBag实例,它拥有各种方便的方法处理错误信息。自动提供给所有视图的$ errors变量,也是MessageBag类的一个实例。查看特定字段的第一个错误信息
要查看特定字段的第一个错误消息,可以使用
first方法:$errors = $validator->errors();echo $errors->first('email');查看特定字段的所有错误消息
如果你需要获取指定字段的所有错误消息的数组,则可以使用
get方法:foreach ($errors->get('email') as $message) { // }如果要验证表单的数组字段,你可以使用
*来获取每个数组元素的所有错误消息:foreach ($errors->get('attachments.*') as $message) { // }查看所有字段的所有错误消息
如果你想要得到所有字段的所有错误消息,可以使用
all方法:foreach ($errors->all() as $message) { // }判断特定字段是否含有错误消息
has方法可以被用来判断给定的字段是否存在错误信息:if ($errors->has('email')) { // }自定义错误消息
如果有需要的话,你也可以使用自定义错误消息取代默认值进行验证。有几种方法可以指定自定义消息。首先,你可以将自定义消息作为第三个参数传递给
Validator::make方法:$messages = [ 'req

