Laravel 內建表單請求驗證、CSRF 保護、資源控制器等機制,讓表單處理既安全又優雅。本文從零建立一個完整的表單提交流程,涵蓋路由定義、控制器方法、Blade 模板、驗證規則與錯誤顯示。
use App\Http\Controllers\FormController;
// 顯示表單頁 (GET)
Route::get('/form', [FormController::class, 'create'])->name('form.create');
// 處理提交 (POST)
Route::post('/submit', [FormController::class, 'store'])->name('form.store');
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Http\Requests\StoreFormRequest; // 表單請求驗證類
class FormController extends Controller
{
// 顯示表單
public function create()
{
return view('form.create');
}
// 處理提交 (注入 FormRequest 自動驗證)
public function store(StoreFormRequest $request)
{
// 驗證通過才會執行到這裡
$validated = $request->validated(); // 只取得通過驗證的資料
// 業務邏輯:儲存資料庫、發送郵件、派發事件...
// $record = FormRecord::create($validated);
return redirect()->route('form.create')
->with('success', '提交成功!資料已儲存。');
}
}
<?php
namespace App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;
class StoreFormRequest extends FormRequest
{
public function authorize()
{
return true; // 或依權限邏輯 return $this->user()->can('create-form');
}
public function rules()
{
return [
'a' => 'required|string|max:50',
'b' => 'required|email',
'c' => 'nullable|numeric|min:0|max:100',
// 陣列驗證範例
'tags.*' => 'string|distinct',
];
}
public function messages()
{
return [
'a.required' => '欄位 A 為必填',
'b.email' => '請輸入有效 Email 格式',
'c.numeric' => '欄位 C 必須為數字',
];
}
}
<!DOCTYPE html>
<html>
<head>
<title>Laravel 表單範例</title>
<meta charset="utf-8">
@vite(['resources/css/app.css']) {{-- 或自行引入 CSS --}}
</head>
<body>
@if (session('success'))
<div class="alert alert-success">{{ session('success') }}</div>
@endif
<form action="{{ route('form.store') }}" method="POST">
@csrf {{-- 自動生成 _token hidden input --}}
<div class="field">
<label>欄位 A (字串)</label>
<input type="text" name="a" value="{{ old('a') }}">
@error('a') <span class="error">{{ $message }}</span> @enderror
</div>
<div class="field">
<label>欄位 B (Email)</label>
<input type="email" name="b" value="{{ old('b') }}">
@error('b') <span class="error">{{ $message }}</span> @enderror
</div>
<div class="field">
<label>欄位 C (數字 0-100)</label>
<input type="number" name="c" value="{{ old('c') }}" min="0" max="100">
@error('c') <span class="error">{{ $message }}</span> @enderror
</div>
<button type="submit">送出</button>
</form>
</body>
</html>
| 機制 | 說明 |
|---|---|
| @csrf | 生成 ``,驗證中間人偽造請求 |
| FormRequest | 驗證失敗自動重導回上頁,攜帶 errors 與 old input,零樣板碼 |
| $request->validated() | 只回傳通過驗證的欄位,防止 Mass Assignment 漏洞 |
| old('field') | 重導後自動回填使用者輸入,提升 UX |
| @error/@enderror | Blade 指令顯示首個驗證錯誤訊息 |
// routes/api.php
Route::post('/form', [FormController::class, 'apiStore'])
->middleware('auth:sanctum'); // 或 auth:api
// Controller
public function apiStore(StoreFormRequest $request)
{
return response()->json([
'message' => 'API 提交成功',
'data' => $request->validated(),
], 201);
}
前端發送 `Content-Type: application/json` + `X-CSRF-TOKEN` (或 Bearer Token) 即可。
遵循「路由 → FormRequest 驗證 → 控制器業務 → 重導/回應」標準流程,即可構建安全、可維護、使用者體驗良好的 Laravel 表單功能。