使用Laravel請求類處理表單驗證？

Laravel 的Form Request 是一種結構化、可複用的表單驗證方式。 1. 它通過專門的類集中管理驗證規則和授權邏輯，避免控制器臃腫；2. 使用Artisan 命令創建後，在rules() 方法中定義字段規則，支持動態參數處理；3. authorize() 方法用於判斷用戶權限，自動返回403 響應；4. 控制器中類型提示該類即可獲取驗證後的安全數據；5. 可自定義錯誤提示和字段別名以提升用戶體驗。這種方式使代碼更清晰、易維護，適合中大型項目。

表單驗證是開發Web 應用中非常重要的一環，Laravel 提供了多種方式來實現驗證邏輯。其中使用Request 類（Form Request）進行表單驗證是一種結構清晰、復用性強的方式，特別適合中大型項目。

什麼是Laravel 的Form Request？

Laravel 的Form Request 是一種專門用於處理表單驗證的類。它繼承自Illuminate\Foundation\Http\FormRequest ，可以將驗證規則和授權邏輯集中管理，避免控制器變得臃腫。

你可以通過Artisan 命令創建一個Form Request：

 php artisan make:request StoreUserRequest

生成的類位於app/Http/Requests目錄下。你只需要在其中定義驗證規則和授權邏輯，就可以在整個應用中復用。

如何定義驗證規則

打開新生成的Request 類，在rules()方法中返回一個包含字段規則的數組。例如：

 public function rules()
{
    return [
        'name' => 'required|string|max:255',
        'email' => 'required|email|unique:users',
        'password' => 'required|min:6',
    ];
}

這個方法與在控制器中使用validate()方法非常相似，但優勢在於可以集中管理這些規則，並且可以在多個地方復用。

注意：如果你需要動態傳入參數，比如編輯用戶時忽略當前用戶的email 唯一性檢查，可以通過閉包或直接注入模型ID 來實現。

授權邏輯放在這裡更合適

除了驗證規則，Form Request 還提供了一個authorize()方法，用來判斷當前用戶是否有權限提交這個表單。例如：

 public function authorize()
{
    return $this->user()->can('create-user');
}

這樣就把權限控制也集中到了一起，使控制器更加簡潔。

如果返回false，Laravel 會自動返回403 響應，不需要你自己去判斷和拋異常。

在控制器中使用Form Request

一旦你定義好了Form Request，就可以在控制器中直接類型提示它：

 public function store(StoreUserRequest $request)
{
    User::create($request->validated());

    return redirect()->route('users.index');
}

這裡$request->validated()返回的是經過驗證的數據，只包含符合規則的字段，避免臟數據被插入數據庫。

小技巧：如果你只想獲取部分驗證後的字段，可以用$request->safe()->only(['name', 'email'])來提取安全數據。

自定義錯誤信息和字段別名（可選）

你還可以在Form Request 中重寫messages()和attributes()方法來自定義錯誤提示和字段名稱：

 public function messages()
{
    return [
        'email.unique' => '該郵箱已被註冊，請換一個試試。 ',
    ];
}

public function attributes()
{
    return [
        'name' => '姓名',
        'email' => '郵箱地址',
    ];
}

這樣可以讓錯誤提示更友好，也更適合多語言場景。

基本上就這些。 Form Request 把驗證、授權、提示都組織在一起，讓代碼更有條理，也更容易維護。雖然一開始可能覺得多建一個類有點麻煩，但在實際項目中你會發現它的價值。

以上是使用Laravel請求類處理表單驗證？的詳細內容。更多資訊請關注PHP中文網其他相關文章！