萬盛學電腦網

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

PHP 表單處理完整實戰:從 HTML 表單建構到 $_POST 資料驗證與安全處理

前言

表單處理是 Web 開發最基礎也最關鍵的環節。本文將從零建構一個包含所有常見輸入類型的複雜表單,詳細解析 HTML 結構、PHP 後端處理流程、資料驗證、安全防護(XSS、CSRF)與最佳實踐,適合初學者建立正確觀念,也供進階開發者查漏補缺。

完整 HTML 表單範例

<!DOCTYPE html>
<html lang="zh-TW">
<head>
    <meta charset="UTF-8">
    <title>會員註冊表單</title>
    <style>
        form { max-width: 600px; margin: 2rem auto; padding: 1.5rem; border: 1px solid #ddd; border-radius: 8px; }
        .form-group { margin-bottom: 1rem; display: flex; align-items: center; }
        label { width: 120px; font-weight: bold; }
        input, select, textarea { flex: 1; padding: 0.5rem; border: 1px solid #ccc; border-radius: 4px; }
        .radio-group, .checkbox-group { display: flex; flex-wrap: wrap; gap: 1rem; flex: 1; }
        .radio-group label, .checkbox-group label { width: auto; font-weight: normal; display: flex; align-items: center; gap: 0.3rem; }
        button { width: 100%; padding: 0.75rem; background: #007bff; color: white; border: none; border-radius: 4px; cursor: pointer; font-size: 1rem; }
        button:hover { background: #0056b3; }
        .error { color: #dc3545; font-size: 0.875rem; margin-top: 0.25rem; }
        .success { color: #28a745; padding: 1rem; background: #d4edda; border-radius: 4px; margin-bottom: 1rem; }
    </style>
</head>
<body>
    <form action="process.php" method="POST" novalidate>
        <!-- 隱藏欄位:識別表單來源 -->
        <input type="hidden" name="form_source" value="register_form">

        <div class="form-group">
            <label for="username">姓名:</label>
            <input type="text" id="username" name="username" value="<?= htmlspecialchars($_POST['username'] ?? '') ?>" required maxlength="50">
        </div>

        <div class="form-group">
            <label for="password">密碼:</label>
            <input type="password" id="password" name="password" required maxlength="20" minlength="8">
        </div>

        <div class="form-group">
            <label for="age">年齡層:</label>
            <select id="age" name="age" required>
                <option value="" disabled selected>請選擇</option>
                <option value="under_18">18 歲以下</option>
                <option value="18_30">18-30 歲</option>
                <option value="31_50">31-50 歲</option>
                <option value="over_50">51 歲以上</option>
            </select>
        </div>

        <div class="form-group">
            <label for="intro">自我介紹:</label>
            <textarea id="intro" name="intro" rows="4" cols="50" placeholder="請輸入您的自我介紹"><?= htmlspecialchars($_POST['intro'] ?? '') ?></textarea>
        </div>

        <div class="form-group">
            <label>運動偏好:</label>
            <div class="radio-group">
                <label><input type="radio" name="fave_sport" value="tennis" required> 網球</label>
                <label><input type="radio" name="fave_sport" value="football"> 足球</label>
                <label><input type="radio" name="fave_sport" value="basketball"> 籃球</label>
                <label><input type="radio" name="fave_sport" value="bowling"> 保齡球</label>
            </div>
        </div>

        <div class="form-group">
            <label>開發語言:</label>
            <div class="checkbox-group">
                <label><input type="checkbox" name="languages[]" value="php"> PHP</label>
                <label><input type="checkbox" name="languages[]" value="javascript"> JavaScript</label>
                <label><input type="checkbox" name="languages[]" value="python"> Python</label>
                <label><input type="checkbox" name="languages[]" value="java"> Java</option>
                <label><input type="checkbox" name="languages[]" value="go"> Go</label>
                <label><input type="checkbox" name="languages[]" value="rust"> Rust</label>
            </div>
        </div>

        <div class="form-group">
            <label for="ide">開發工具(可多選):</label>
            <select id="ide" name="develop_ide[]" multiple size="5">
                <option value="vscode" selected>VS Code</option>
                <option value="phpstorm">PhpStorm</option>
                <option value="sublime">Sublime Text</option>
                <option value="vim">Vim/Neovim</option>
                <option value="other">其他</option>
            </select>
            <small>按住 Ctrl/Cmd 可多選</small>
        </div>

        <button type="submit" name="btn_submit">提交註冊</button>
    </form>
</body>
</html>

表單元素類型對照與關鍵屬性

類型HTML 標籤關鍵屬性PHP 接收型別
單行文字<input type="text">maxlength, required, patternstring
密碼<input type="password">maxlength, minlengthstring(明文)
下拉選單<select><option>multiple, size, selectedstring / array (multiple)
多行文字<textarea>rows, cols, maxlengthstring(含換行)
單選按鈕<input type="radio">同 name 分組, value, checkedstring(單值)
複選框<input type="checkbox">name 以 [] 結尾, value, checkedarray(多值)
多選下拉<select multiple>name 以 [] 結尾, sizearray(多值)
隱藏欄位<input type="hidden">valuestring
檔案上傳<input type="file">accept, multiple$_FILES 陣列

PHP 後端處理核心邏輯 (process.php)

<?php
declare(strict_types=1);
session_start();

// CSRF Token 驗證(簡化版,生產環境建議用專門庫)
function validateCsrf(): bool {
    if (empty($_SESSION['csrf_token']) || empty($_POST['csrf_token'])) return false;
    return hash_equals($_SESSION['csrf_token'], $_POST['csrf_token']);
}

// 產生 CSRF Token
if (empty($_SESSION['csrf_token'])) {
    $_SESSION['csrf_token'] = bin2hex(random_bytes(32));
}

// 僅處理 POST 請求
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    http_response_code(405);
    exit('Method Not Allowed');
}

// CSRF 驗證
if (!validateCsrf()) {
    http_response_code(403);
    exit('CSRF Token 驗證失敗,請重新載入頁面。');
}

// 表單來源驗證
if (($_POST['form_source'] ?? '') !== 'register_form') {
    http_response_code(400);
    exit('非法表單來源。');
}

// === 資料驗證與過濾 ===
$errors = [];
$data = [];

// 1. 姓名:必填、長度、只允許中英數底線
$username = trim($_POST['username'] ?? '');
if ($username === '') {
    $errors['username'] = '姓名為必填';
} elseif (mb_strlen($username) > 50) {
    $errors['username'] = '姓名不得超過 50 字元';
} elseif (!preg_match('/^[\p{L}\p{N}_\s]+$/u', $username)) {
    $errors['username'] = '姓名僅允許中英文、數字、底線與空白';
} else {
    $data['username'] = $username;
}

// 2. 密碼:必填、長度、複雜度
$password = $_POST['password'] ?? '';
if ($password === '') {
    $errors['password'] = '密碼為必填';
} elseif (strlen($password) < 8 || strlen($password) > 20) {
    $errors['password'] = '密碼長度需 8-20 字元';
} elseif (!preg_match('/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).+$/', $password)) {
    $errors['password'] = '密碼需包含大小寫字母與數字';
} else {
    $data['password_hash'] = password_hash($password, PASSWORD_ARGON2ID); // 真實環境存雜湊
}

// 3. 年齡層:必填、白名單驗證
$allowedAges = ['under_18', '18_30', '31_50', 'over_50'];
$age = $_POST['age'] ?? '';
if (!in_array($age, $allowedAges, true)) {
    $errors['age'] = '請選擇有效的年齡層';
} else {
    $data['age'] = $age;
}

// 4. 自我介紹:選填、長度限制、XSS 過濾
$intro = trim($_POST['intro'] ?? '');
if ($intro !== '' && mb_strlen($intro) > 500) {
    $errors['intro'] = '自我介紹不得超過 500 字元';
}
$data['intro'] = $intro; // 存原文,輸出時再 htmlspecialchars

// 5. 運動偏好:必填、白名單
$allowedSports = ['tennis', 'football', 'basketball', 'bowling'];
$sport = $_POST['fave_sport'] ?? '';
if (!in_array($sport, $allowedSports, true)) {
    $errors['fave_sport'] = '請選擇運動偏好';
} else {
    $data['fave_sport'] = $sport;
}

// 6. 開發語言:選填、陣列、白名單過濾
$allowedLangs = ['php', 'javascript', 'python', 'java', 'go', 'rust'];
$submittedLangs = $_POST['languages'] ?? [];
if (!is_array($submittedLangs)) $submittedLangs = [];
$langs = array_intersect($submittedLangs, $allowedLangs);
$data['languages'] = $langs;

// 7. 開發工具:選填、陣列、白名單
$allowedIdes = ['vscode', 'phpstorm', 'sublime', 'vim', 'other'];
$submittedIdes = $_POST['develop_ide'] ?? [];
if (!is_array($submittedIdes)) $submittedIdes = [];
$ides = array_intersect($submittedIdes, $allowedIdes);
$data['develop_ide'] = $ides;

// === 處理結果 ===
if ($errors) {
    // 驗證失敗:回傳錯誤(AJAX 回傳 JSON,傳統表單重導並攜帶錯誤)
    header('Content-Type: application/json; charset=utf-8');
    echo json_encode(['success' => false, 'errors' => $errors, 'old' => $_POST]);
    exit;
}

// 成功:這裡可寫入資料庫、發送郵件等
// $userId = User::create($data);

// 重新產生 CSRF Token
$_SESSION['csrf_token'] = bin2hex(random_bytes(32));

// 回傳成功(或重導向成功頁)
header('Content-Type: application/json; charset=utf-8');
echo json_encode([
    'success' => true,
    'message' => '註冊成功!',
    'data' => [
        'username' => $data['username'],
        'age' => $data['age'],
        'fave_sport' => $data['fave_sport'],
        'languages' => $data['languages'],
        'develop_ide' => $data['develop_ide'],
    ]
]);
?>

關鍵安全防護重點

1. XSS (Cross-Site Scripting) 防護

  • 輸出時轉義:htmlspecialchars($str, ENT_QUOTES, 'UTF-8')
  • 輸入時不轉義:保存原始資料,輸出時才轉義(單一真實來源)
  • 模板引擎(Twig, Blade, Latte)預設自動轉義,強烈建議使用

2. CSRF (Cross-Site Request Forgery) 防護

  • 每個 Session 產生唯一 Token,表單隱藏欄位攜帶
  • 後端驗證 Token 正確性(使用 hash_equals() 防時序攻擊)
  • SameSite Cookie 屬性(Lax/Strict)作為第二道防線

3. SQL Injection 防護

  • 絕對禁止字串拼接 SQL
  • 使用 PDO Prepared Statements:$stmt = $pdo->prepare('INSERT ...'); $stmt->execute($params);
  • 或使用 ORM(Eloquent, Doctrine, Cycle ORM)

4. 檔案上傳安全(若有檔案欄位)

  • 驗證 MIME 型別(finfo_file()),不信任副檔名
  • 重新命名檔案(UUID + 副檔名),存放於 Web Root 外
  • 限制檔案大小(php.ini + 程式碼雙重限制)
  • 圖片重新處理(GD/Imagick)移除潛在惡意代碼

資料保留與錯誤顯示(傳統表單非 AJAX)

若不使用 AJAX,驗證失敗需重導回表單頁並保留輸入:

<?php
// process.php 失敗時
$_SESSION['form_errors'] = $errors;
$_SESSION['form_old'] = $_POST;
header('Location: form.php');
exit;

// form.php 頂端
$errors = $_SESSION['form_errors'] ?? [];
$old = $_SESSION['form_old'] ?? [];
unset($_SESSION['form_errors'], $_SESSION['form_old']);

// 輸入框值:value="<?= htmlspecialchars($old['username'] ?? '') ?>"
// 錯誤顯示:<?php if (isset($errors['username'])): ?><span class="error"><?= $errors['username'] ?></span><?php endif; ?>
?>

nl2br() 與換行處理

資料庫儲存原始換行(\n),前端顯示時轉換:

<?php
// 儲存時:直接存 $intro(含 \n)
// 顯示時:
echo nl2br(htmlspecialchars($intro, ENT_QUOTES, 'UTF-8'));
// 或 CSS 白空間保留:white-space: pre-wrap;
?>

結語

表單處理看似基礎,實則包含資料驗證、安全防護、使用者體驗、錯誤處理等多層面向。建立「不信任任何輸入、輸出時轉義、最小權限原則、分層防護」的防禦心法,配合現代框架(Laravel, Symfony)或獨立元件(Symfony Validator, laminas-inputfilter)的驗證機制,才能構建安全可靠的 Web 應用程式。

copyright © 萬盛學電腦網 all rights reserved