表單處理是 Web 開發最基礎也最關鍵的環節。本文將從零建構一個包含所有常見輸入類型的複雜表單,詳細解析 HTML 結構、PHP 後端處理流程、資料驗證、安全防護(XSS、CSRF)與最佳實踐,適合初學者建立正確觀念,也供進階開發者查漏補缺。
<!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, pattern | string |
| 密碼 | <input type="password"> | maxlength, minlength | string(明文) |
| 下拉選單 | <select><option> | multiple, size, selected | string / array (multiple) |
| 多行文字 | <textarea> | rows, cols, maxlength | string(含換行) |
| 單選按鈕 | <input type="radio"> | 同 name 分組, value, checked | string(單值) |
| 複選框 | <input type="checkbox"> | name 以 [] 結尾, value, checked | array(多值) |
| 多選下拉 | <select multiple> | name 以 [] 結尾, size | array(多值) |
| 隱藏欄位 | <input type="hidden"> | value | string |
| 檔案上傳 | <input type="file"> | accept, multiple | $_FILES 陣列 |
<?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'],
]
]);
?>
htmlspecialchars($str, ENT_QUOTES, 'UTF-8')hash_equals() 防時序攻擊)$stmt = $pdo->prepare('INSERT ...'); $stmt->execute($params);finfo_file()),不信任副檔名若不使用 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; ?>
?>
資料庫儲存原始換行(\n),前端顯示時轉換:
<?php
// 儲存時:直接存 $intro(含 \n)
// 顯示時:
echo nl2br(htmlspecialchars($intro, ENT_QUOTES, 'UTF-8'));
// 或 CSS 白空間保留:white-space: pre-wrap;
?>
表單處理看似基礎,實則包含資料驗證、安全防護、使用者體驗、錯誤處理等多層面向。建立「不信任任何輸入、輸出時轉義、最小權限原則、分層防護」的防禦心法,配合現代框架(Laravel, Symfony)或獨立元件(Symfony Validator, laminas-inputfilter)的驗證機制,才能構建安全可靠的 Web 應用程式。