Laravel形式驗證教程

Laravel 表單驗證可通過控制器中的validate() 方法實現，1. 使用validate() 定義規則如required、email、unique 等確保數據合規；2. 可在validate() 中傳入第二個參數自定義錯誤消息，或在lang/zh-CN/validation.php 中設置全局中文提示；3. 在Blade 模板中使用@error 指令顯示錯誤信息，並用old() 保留輸入值；4. 高級技巧包括：a) 使用sometimes 實現條件驗證，b) 通過users.*.name 語法驗證數組字段，c) 創建表單請求類（php artisan make:request）分離複雜驗證邏輯；5. 常見規則有required、string、numeric、array、confirmed、unique、exists、min、max、regex 和nullable。完整流程確保數據安全且用戶體驗良好，最終實現開箱即用的可靠表單處理。

Laravel 的表單驗證功能強大又靈活，能幫你輕鬆確保用戶提交的數據符合預期。下面是一個實用的Laravel 表單驗證教程，適合初學者和想鞏固基礎的人。

1. 基礎表單驗證（使用控制器驗證）

最常見的驗證方式是在控制器中使用validate()方法。假設你有一個用戶註冊表單，需要驗證姓名、郵箱和密碼。

 // 在你的控制器中public function store(Request $request)
{
    $validated = $request->validate([
        'name' => 'required|string|max:255',
        'email' => 'required|email|unique:users',
        'password' => 'required|min:8|confirmed',
    ]);

    // 驗證通過後，保存用戶User::create($validated);

    return redirect()->route('users.index')->with('success', '用戶創建成功！');
}

說明：

• required ：字段必須存在且不為空。
• string ：必須是字符串。
• max:255 ：最長255 字符。
• email ：必須是合法郵箱格式。
• unique:users ：在users 表中唯一。
• min:8 ：密碼最少8 位。
• confirmed ：必須有一個對應的password_confirmation字段，且值相同。

如果驗證失敗，Laravel 會自動重定向回上一頁，並將錯誤信息存入session。

2. 自定義錯誤提示消息

默認的錯誤消息是英文的，你可以自定義更友好的提示：

 $validated = $request->validate([
    'name' => 'required|string|max:255',
    'email' => 'required|email|unique:users',
    'password' => 'required|min:8|confirmed',
], [
    'name.required' => '姓名不能為空',
    'email.email' => '請輸入有效的郵箱地址',
    'password.min' => '密碼至少需要8 個字符',
    'password.confirmed' => '兩次輸入的密碼不一致',
]);

你也可以在lang/zh-CN/validation.php中設置全局中文提示，讓整個項目統一。

3. 在Blade 模板中顯示錯誤信息

在視圖中，使用$errors變量顯示驗證失敗信息：

 <!-- resources/views/users/create.blade.php -->
<form method="POST" action="{{ route(&#39;users.store&#39;) }}">
    @csrf

    <div>
        <label>姓名</label>
        <input type="text" name="name" value="{{ old(&#39;name&#39;) }}">
        @error(&#39;name&#39;)
            <span style="color: red;">{{ $message }}</span>
        @enderror
    </div>

    <div>
        <label>郵箱</label>
        <input type="email" name="email" value="{{ old(&#39;email&#39;) }}">
        @error(&#39;email&#39;)
            <span style="color: red;">{{ $message }}</span>
        @enderror
    </div>

    <div>
        <label>密碼</label>
        <input type="password" name="password">
        @error(&#39;password&#39;)
            <span style="color: red;">{{ $message }}</span>
        @enderror
    </div>

    <div>
        <label>確認密碼</label>
        <input type="password" name="password_confirmation">
    </div>

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

• @error('field')會檢查該字段是否有錯誤。
• old('name')保留用戶輸入，避免表單重填。

4. 高級驗證技巧

a) 條件驗證（有時需要，有時不需要）

使用sometimes規則：

 $request->validate([
    'phone' => 'sometimes|required|numeric',
]);

只有當phone字段存在時才驗證。

b) 驗證數組字段

比如批量添加用戶：

 $request->validate([
    'users.*.name' => 'required|string',
    'users.*.email' => 'required|email',
]);

c) 使用表單請求類（Form Request）——適合複雜驗證

生成一個專門的請求類：

 php artisan make:request StoreUserRequest

編輯生成的app/Http/Requests/StoreUserRequest.php ：

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

public function messages()
{
    return [
        'name.required' => '姓名必填',
        'email.unique' => '該郵箱已被註冊',
    ];
}

在控制器中使用：

 public function store(StoreUserRequest $request)
{
    User::create($request->validated());
    return redirect()->route('users.index');
}

這種方式更清晰，尤其適合大型項目。

5. 常見驗證規則速查

基本上就這些。 Laravel 的驗證機制開箱即用，結合validate() 、自定義消息和Blade 錯誤展示，能快速實現安全可靠的表單處理。不復雜，但容易忽略細節，比如confirmed需要對應字段， unique要注意更新時忽略當前用戶等。

以上是Laravel形式驗證教程的詳細內容。更多資訊請關注PHP中文網其他相關文章！