萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Laravel 表單提交完整實作:路由、控制器、請求驗證、CSRF 保護

Laravel 內建表單請求驗證、CSRF 保護、資源控制器等機制,讓表單處理既安全又優雅。本文從零建立一個完整的表單提交流程,涵蓋路由定義、控制器方法、Blade 模板、驗證規則與錯誤顯示。

1. 定義路由 (routes/web.php)

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');

2. 建立控制器 (app/Http/Controllers/FormController.php)

<?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', '提交成功!資料已儲存。');
    }
}

3. 表單請求驗證類 (app/Http/Requests/StoreFormRequest.php)

<?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 必須為數字',
        ];
    }
}

4. Blade 模板 (resources/views/form/create.blade.php)

<!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/@enderrorBlade 指令顯示首個驗證錯誤訊息

進階:API 表單提交 (JSON + Sanctum/Passport)


// 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) 即可。

常見問題快速排查

  • 419 PAGE EXPIRED:缺少 `@csrf` 或 Session 過期 → 檢查 `config/session.php` lifetime、確保表單含 `@csrf`。
  • 驗證不生效:控制器方法參數必須型別提示 `StoreFormRequest $request`,否則不會自動注入驗證。
  • 檔案上傳:表單加 `enctype="multipart/form-data"`,驗證規則用 `file|image|max:2048`,控制器用 `$request->file('avatar')->store('avatars')`。

遵循「路由 → FormRequest 驗證 → 控制器業務 → 重導/回應」標準流程,即可構建安全、可維護、使用者體驗良好的 Laravel 表單功能。

copyright © 萬盛學電腦網 all rights reserved