所有示例基于Laravel 5.1.39 (LTS)
今天天气不错,我们来说说表单验证。
Controller中做表单验证
有的同学把表单验证逻辑写在Controller中,例如这个对用户提交评论内容的验证:
all(), [
'comment' => 'required', // 只是实例,就写个简单的规则,你的网站要是这么写欢迎在评论里贴网址
]);
if ($validator->fails()) {
return redirect()
->back()
->withErrors($validator)
->withInput();
}
}
这样写的话,表单验证和业务逻辑挤在一起,我们的Controller
中就会有太多的代码,而且重复的验证规则基本也是复制粘贴。
我们可以利用Form Request
来封装表单验证代码,从而精简Controller
中的代码逻辑,使其专注于业务。而独立出去的表单验证逻辑甚至可以复用到其它请求中,例如修改评论。
什么是Form Request
在Laravel
中,每一个请求都会被封装为一个Request
对象,Form Request
对象就是包含了额外验证逻辑(以及访问权限控制)的自定义Request
类。
如何使用Form Request做表单验证
Laravel
提供了生成Form Request
的Artisan
命令:
$ php artisan make:request StoreCommentRequest
于是就生成了app/Http/Requests/StoreCommentRequest.php
,让我们来分析一下内容:
那么很容易,我们除了让authorize
方法返回true
之外,还得让rules
方法返回我们的验证规则:
接着修改我们的Controller
:
这样Laravel
便会自动调用StoreCommentRequest
进行表单验证了。
异常处理
如果表单验证失败,Laravel
会重定向到之前的页面,并且将错误写到Session
中,如果是AJAX
请求,则会返回一段HTTP
状态为422
的JSON
数据,类似这样:
{comment: ["The comment field is required."]}
这里就不细说提示信息怎么修改了,如果有人想看相关教程,可以留言。
我们主要来说说怎么定制错误处理。
通常来说,Laravel
中的错误都是异常(Exception
),我们都可以在app\Exceptions\handler.php
中进行统一处理。Form Request
确实也抛出了一个Illuminate\Http\Exception\HttpResponseException
异常,但这个异常是在路由逻辑中就被特殊处理了。
首先我们来看看Form Request
是如何被执行的:
Illuminate\Validation\ValidationServiceProvider
:
registerValidationResolverHook(); // 看我看我看我
$this->registerPresenceVerifier();
$this->registerValidationFactory();
}
/**
* Register the "ValidatesWhenResolved" container hook.
*
* @return void
*/
protected function registerValidationResolverHook() // 对,就是我
{
// 这里可以看到对`ValidatesWhenResolved`的实现做了一个监听
$this->app->afterResolving(function (ValidatesWhenResolved $resolved) {
$resolved->validate(); // 然后调用了它的`validate`方法进行验证
});
}
// ...
你猜对了,Form Request
就实现了这个Illuminate\Contracts\Validation\ValidatesWhenResolved
接口:
FormRequest
基类中的validate
方法是由这个Illuminate\Validation\ValidatesWhenResolvedTrait
实现的:
Illuminate\Validation\ValidatesWhenResolvedTrait
:
getValidatorInstance(); // 这里获取了`Validator`实例
if (! $this->passesAuthorization()) {
$this->failedAuthorization(); // 这是调用了访问授权的失败处理
} elseif (! $instance->passes()) {
$this->failedValidation($instance); // 这里调用了验证失败的处理,我们主要看这里
}
}
// ...
在validate
里,如果验证失败了就会调用$this->failedValidation()
,继续:
Illuminate\Foundation\Http\FormRequest
:
response( // 这里抛出了传说中的异常
$this->formatErrors($validator)
));
}
终于看到异常了!可是这个异常在另一个地方被处理了:
Illuminate\Routing\Route
:
container = $this->container ?: new Container;
try {
if (! is_string($this->action['uses'])) {
return $this->runCallable($request);
}
if ($this->customDispatcherIsBound()) {
return $this->runWithCustomDispatcher($request);
}
return $this->runController($request);
} catch (HttpResponseException $e) { // 就是这里
return $e->getResponse(); // 这里直接返回了Response给客户端
}
}
// ...
至此,整个思路已然清晰,不过我们还是看看这里生成的HttpResponseException
异常中的Response
是怎么生成的:
Illuminate\Foundation\Http\FormRequest
:
ajax() || $this->wantsJson()) { // 对AJAX请求的处理
return new JsonResponse($errors, 422);
}
return $this->redirector->to($this->getRedirectUrl()) // 对普通表单提交的处理
->withInput($this->except($this->dontFlash))
->withErrors($errors, $this->errorBag);
// ...
相信你都看明白了。
如何实现自定义错误处理,这里提供两个思路,都需要重写app\Http\Requests\Request
的failedValidation
:
抛出一个新异常,继承
HttpResponseException
异常,重新实现getResponse
方法,这个异常类我们可以放到app/Exceptions/
下便于管理,错误返回依然交给Laravel
;抛出一个我们自定义的异常,在
app\Exceptions\handler
中处理。
具体实现这里就不写啦,如果你有别的方法或者想法可以在评论中和我交流。
补充
如果你的Controller
使用Illuminate\Foundation\Validation\ValidatesRequests
这个Trait
的validate
方法进行验证,同样的,这里验证失败也会抛出Illuminate\Http\Exception\HttpResponseException
异常,可以参考上面的解决方案进行处理。
参考
Laravel 5.1官方文档