Laravel中怎么使用FormRequest進行表單驗證

Laravel中怎么使用FormRequest進行表單驗證，相信很多沒有經驗的人對此束手無策，為此本文總結了問題出現的原因和解決方法，通過這篇文章希望你能解決這個問題。

Controller中做表單驗證

有的同學把表單驗證邏輯寫在Controller中，例如這個對用戶提交評論內容的驗證：

<?php

// ... 

use Validator;

class CommentController
{

  public function postStoreComment(Request $request)
  {
    $validator = Validator::make($request->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命令：

<code>$ php artisan make:request StoreCommentRequest</code>

于是就生成了app/Http/Requests/StoreCommentRequest.php，讓我們來分析一下內容：

<?php

namespace App\Http\Requests;

use App\Http\Requests\Request; // 可以看到，這個基類是在我們的項目中的，這意味著我們可以修改它

class StoreCommentRequest extends Request
{
  /**
   * Determine if the user is authorized to make this request.
   *
   * @return bool
   */
  public function authorize() // 這個方法可以用來控制訪問權限，例如禁止未付費用戶評論…
  {
    return false; // 注意！這里默認是false，記得改成true
  }

  /**
   * Get the validation rules that apply to the request.
   *
   * @return array
   */
  public function rules() // 這個方法返回驗證規則數組，也就是Validator的驗證規則
  {
    return [
      //
    ];
  }
}

那么很容易，我們除了讓authorize方法返回true之外，還得讓rules方法返回我們的驗證規則：

<?php

// ...

  public function rules()
  {
    return [

    ];
  }

// ...

接著修改我們的Controller：

<?php

// ...

  // 之前：public function postStoreComment(Request $request)
  public function postStoreComment(\App\Http\Requests\StoreCommentRequest $request)
  {
    // ...
  }

// ...

這樣Laravel便會自動調用StoreCommentRequest進行表單驗證了。

異常處理

如果表單驗證失敗，Laravel會重定向到之前的頁面，并且將錯誤寫到Session中，如果是AJAX請求，則會返回一段HTTP狀態為422的JSON數據，類似這樣：

<code>{comment: ["The comment field is required."]}</code>

這里就不細說提示信息怎么修改了，如果有人想看相關教程，可以留言。

我們主要來說說怎么定制錯誤處理。

通常來說，Laravel中的錯誤都是異常（Exception），我們都可以在app\Exceptions\handler.php中進行統一處理。Form Request確實也拋出了一個Illuminate\Http\Exception\HttpResponseException異常，但這個異常是在路由邏輯中就被特殊處理了。

首先我們來看看Form Request是如何被執行的：

Illuminate\Validation\ValidationServiceProvider：

<?php

namespace Illuminate\Validation;

use Illuminate\Support\ServiceProvider;
use Illuminate\Contracts\Validation\ValidatesWhenResolved;

class ValidationServiceProvider extends ServiceProvider
{
  /**
   * Register the service provider.
   *
   * @return void
   */
  public function register()
  {
    $this->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接口：

<?php 

namespace Illuminate\Foundation\Http;

use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Illuminate\Http\JsonResponse;
use Illuminate\Routing\Redirector;
use Illuminate\Container\Container;
use Illuminate\Contracts\Validation\Validator;
use Illuminate\Http\Exception\HttpResponseException;
use Illuminate\Validation\ValidatesWhenResolvedTrait;
use Illuminate\Contracts\Validation\ValidatesWhenResolved; // 是你
use Illuminate\Contracts\Validation\Factory as ValidationFactory;

// 我們`app\Http\Requests\Request`便是繼承于這個`FormRequest`類
class FormRequest extends Request implements ValidatesWhenResolved // 就是你
{
  use ValidatesWhenResolvedTrait; // 這個我們待會兒也要看看

  // ...

FormRequest基類中的validate方法是由這個Illuminate\Validation\ValidatesWhenResolvedTrait實現的：

Illuminate\Validation\ValidatesWhenResolvedTrait:

<?php

namespace Illuminate\Validation;

use Illuminate\Contracts\Validation\ValidationException;
use Illuminate\Contracts\Validation\UnauthorizedException;

/**
 * Provides default implementation of ValidatesWhenResolved contract.
 */
trait ValidatesWhenResolvedTrait
{
  /**
   * Validate the class instance.
   *
   * @return void
   */
  public function validate() // 這里實現了`validate`方法
  {
    $instance = $this->getValidatorInstance(); // 這里獲取了`Validator`實例

    if (! $this->passesAuthorization()) {
      $this->failedAuthorization(); // 這是調用了訪問授權的失敗處理
    } elseif (! $instance->passes()) {
      $this->failedValidation($instance); // 這里調用了驗證失敗的處理，我們主要看這里
    }
  }

  // ...

在validate里，如果驗證失敗了就會調用$this->failedValidation()，繼續：

Illuminate\Foundation\Http\FormRequest：

<?php

// ...

  /**
   * Handle a failed validation attempt.
   *
   * @param \Illuminate\Contracts\Validation\Validator $validator
   * @return mixed
   */
  protected function failedValidation(Validator $validator)
  {
    throw new HttpResponseException($this->response( // 這里拋出了傳說中的異常
      $this->formatErrors($validator)
    ));
  }

終于看到異常了！可是這個異常在另一個地方被處理了：

Illuminate\Routing\Route：

<?php

  // ...

  /**
   * Run the route action and return the response.
   *
   * @param \Illuminate\Http\Request $request
   * @return mixed
   */
  public function run(Request $request)
  {
    $this->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：

<?php

// ...

  // 132行：
  if ($this->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中處理。

看完上述內容，你們掌握Laravel中怎么使用FormRequest進行表單驗證的方法了嗎？如果還想學到更多技能或想了解更多相關內容，歡迎關注億速云行業資訊頻道，感謝各位的閱讀！