如何在 Laravel 中以优雅的方式處理表單驗證錯誤？

在現代網頁開發中，表單驗證是確保數據完整性与安全性的關鍵步驟。Laravel 作為一個備受歡迎的 PHP 框架，提供了強大且靈活的表單驗證機制。然而，許多開發者在處理表單驗證錯誤時，常常會遇到代碼冗餘、錯誤信息顯示方式不友善等問題。那麼，如何在 Laravel 中以优雅的方式處理表單驗證錯誤呢？本文將為您詳細解答這些問題。

Laravel表單驗證基礎

Laravel提供了多種方式來進行表單驗證，最常見的方式是在控制器中進行驗證。 確認其有效性 方法。例如：

public function store(Request $request)
{
    $validatedData = $request->validate([
        'name' => 'required|max:255',
        'email' => 'required|email|unique:users',
        'password' => 'required|min:8',  
    });  

    // 验證通過後，繼續進行後續處理  
}

如果驗證失敗，Laravel 會自動將用戶重定向回上一個頁面，並顯示錯誤信息。這種方式簡單直接，但在複雜的業務邏輯中，控制器可能會變得臃腫不堪。

使用表單請求類進行驗證

為了保持控制器的簡潔性，建議使用表單請求類來處理驗證邏輯。你可以透過 Artisan 命令來創建一個表單請求類：

php artisan make:request StoreUserRequest

接下來，在該類別中定義驗證規則：

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StoreUserRequest extends FormRequest
{
    public function authorize()
    {
        return true;
    }

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

在控制器中，你可以直接使用這個表單請求類：

public function store(StoreUserRequest $request)
{
    // 验證通過後再繼續處理
}

自定義驗證錯誤訊息

Laravel 允許你自定驗證錯誤訊息，這樣才能讓它更符合你的應用場景。你可以在表單請求類中覆寫這些訊息。 訊息 方法：

public function messages()
{
    return [
        'name.required' => '姓名是必填项',
        'email.email' => '请输入有效的邮箱地址',
        'password.min' => 「密碼至少需要 8 個字符，」
    ];
}

如此一來，當驗證失敗時，用戶將看到更友善的錯誤提示。

以優雅的方式在視圖中顯示錯誤訊息

在 Blade 模板中，Laravel 提供了便捷的方式來顯示驗證錯誤訊息。你可以使用這些方法來實現。 錯誤數量 變量用於存取錯誤訊息。例如：

<form method="POST" action="{{ route('users.store') }}">
    @csrf

    <div>
        <label for="name">姓名</label>
        <input type="text" id="name" name="name">
        @error('name')
            <div class="error">{{ $message }}</div>
        @enderror
    </div>

    <div>
        <label for="email">邮箱</label>
        <input type="email" id="email" name="email">
        @error('email')
            <div class="error">{{ $message }}</div>
        @enderror
    </div>

    <div>
        <label for="password">密码</label>
        <input type="password" id="password" name="password">
        @error('password')
            <div class="error">{{ $message }}</div>
        @enderror
    </div>

    <button type="submit">提交</button>
</form>>

通過了 @錯誤訊息 藉由這個指令，你可以輕鬆地為每個表單字段顯示對應的錯誤信息，從而提升用戶體驗。

高級技巧：全局錯誤處理

如果你希望在全局範圍內統一處理驗證錯誤，可以自定義異常處理程序。 app/Exceptions/Handler.php 在文件中進行修改。 呈現出來 方法：

public function render($request, Throwable $exception)
{
    if ($exception instanceof ValidationException) {
        return response()->json([
            'message' => '验证失败',
            'errors' => $exception->errors(),  
        ], 422);  
}  

return parent::render($request, $exception);

如此一來，當驗證失敗時，API 请求將返回統一格式的 JSON 錯誤回應，這有助於前端進行處理。

總結

在 Laravel 中以优雅的方式處理表單驗證錯誤，不僅能提升代碼的可維護性，還能改善用戶體驗。透過使用表單請求類、自定錯誤訊息，以及在視圖中合理顯示錯誤資訊，你就可以打造出更加穩健且用戶友好的應用程序。希望本文提供的技巧能幫助你在 Laravel 开發中更加得心應手。