表單處理是 Web 開發最基礎也最關鍵的環節。本文系統整理 PHP 處理 GET/POST 請求的差異、資料驗證技巧、安全防護措施與現代最佳實踐,幫助你建立健壯的表單處理機制。
| 特性 | GET | POST |
|---|---|---|
| 資料位置 | URL 查詢字串 (?key=val) | HTTP Request Body |
| 可見性 | 瀏覽器網址列明文可見 | 不直接顯示於網址列 |
| 長度限制 | 約 2048 字元 (瀏覽器/伺服器限制) | 理論無上限 (受 post_max_size 限制) |
| 快取行為 | 可被快取、書籤、分享 | 不會被快取/書籤 |
| 歷史紀錄 | 保留在瀏覽歷史 | 不保留參數 |
| 資料類型 | 僅 ASCII 字串 | 支援二進位、multipart/form-data (檔案上傳) |
| 適用場景 | 搜尋、分頁、篩選、非敏感資料查詢 | 登入、註冊、修改資料、檔案上傳、敏感操作 |
| 安全性 | 低 (易受 CSRF、記錄洩漏) | 較高 (但仍需 CSRF Token 防護) |
search.html
<!DOCTYPE html>
<html><head><meta charset="UTF-8"><title>搜尋</title></head>
<body>
<form action="search.php" method="GET">
<input type="search" name="q" placeholder="輸入關鍵字" value="<?= htmlspecialchars($_GET['q'] ?? '') ?>">
<select name="category">
<option value="">全部分類</option>
<option value="news">新聞</option>
<option value="product">商品</option>
</select>
<button type="submit">搜尋</button>
</form>
</body></html>
search.php
<?php
$keyword = trim($_GET['q'] ?? '');
$category = $_GET['category'] ?? '';
if ($keyword === '') {
echo '請輸入搜尋關鍵字';
exit;
}
// 安全處理:防 SQL Injection (使用 PDO prepared statement)
// 防 XSS (輸出時 htmlspecialchars)
$safeKeyword = htmlspecialchars($keyword, ENT_QUOTES, 'UTF-8');
echo "搜尋關鍵字:{$safeKeyword}";
if ($category) echo " 分類:{$category}";
// 實際查詢資料庫...
register.html
<form action="register.php" method="POST" enctype="multipart/form-data">
<input type="hidden" name="csrf_token" value="<?= $_SESSION['csrf_token'] ?>">
<div><label>帳號: <input type="text" name="username" required></label></div>
<div><label>密碼: <input type="password" name="password" required minlength="8"></label></div>
<div><label>大頭照: <input type="file" name="avatar" accept="image/*"></label></div>
<button type="submit">註冊</button>
</form>
register.php
<?php
session_start();
// 1. 驗證 CSRF Token
if (!hash_equals($_SESSION['csrf_token'] ?? '', $_POST['csrf_token'] ?? '')) {
die('CSRF 驗證失敗');
}
// 2. 資料驗證與清理
$errors = [];
$username = trim($_POST['username'] ?? '');
$password = $_POST['password'] ?? '';
if ($username === '') $errors[] = '帳號不可為空';
elseif (strlen($username) < 3) $errors[] = '帳號至少 3 字元';
elseif (!preg_match('/^[a-zA-Z0-9_]+$/', $username)) $errors[] = '帳號僅限英數底線';
if (strlen($password) < 8) $errors[] = '密碼至少 8 字元';
if (!preg_match('/[A-Z]/', $password)) $errors[] = '密碼需含大寫字母';
if (!preg_match('/[a-z]/', $password)) $errors[] = '密碼需含小寫字母';
if (!preg_match('/\d/', $password)) $errors[] = '密碼需含數字';
// 3. 檔案上傳處理
$avatarPath = null;
if (isset($_FILES['avatar']) && $_FILES['avatar']['error'] === UPLOAD_ERR_OK) {
$allowed = ['image/jpeg', 'image/png', 'image/webp'];
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$mime = finfo_file($finfo, $_FILES['avatar']['tmp_name']);
if (!in_array($mime, $allowed)) {
$errors[] = '僅允許 JPG/PNG/WebP 格式';
} elseif ($_FILES['avatar']['size'] > 2 * 1024 * 1024) {
$errors[] = '檔案不可超過 2MB';
} else {
$ext = ['image/jpeg'=>'.jpg','image/png'=>'.png','image/webp'=>'.webp'][$mime];
$avatarPath = 'uploads/' . bin2hex(random_bytes(16)) . $ext;
move_uploaded_file($_FILES['avatar']['tmp_name'], $avatarPath);
}
}
if ($errors) {
$_SESSION['errors'] = $errors;
$_SESSION['old'] = ['username' => $username];
header('Location: register.html');
exit;
}
// 4. 業務邏輯 (密碼雜湊、寫入資料庫...)
$hash = password_hash($password, PASSWORD_BCRYPT);
// PDO insert...
// 5. 重導向防止重複提交 (PRG Pattern)
header('Location: login.php?registered=1');
exit;
Post-Redirect-Get:POST 處理完成後 302/303 重導向 到 GET 頁面,防止使用者重新整理重複提交。
<?php
// 產生 Token (登入/表單頁面)
$_SESSION['csrf_token'] = bin2hex(random_bytes(32));
// 驗證 Token (處理頁面)
if (!hash_equals($_SESSION['csrf_token'], $_POST['csrf_token'] ?? '')) {
http_response_code(403);
die('Invalid CSRF token');
}
required, pattern, minlength, type="email/number/url" — 使用者體驗優化,非安全防線。<?php
function validationFailed(array $errors): never {
http_response_code(422);
header('Content-Type: application/json');
echo json_encode([
'success' => false,
'message' => '驗證失敗',
'errors' => $errors, // ['field' => ['錯誤1', '錯誤2']]
]);
exit;
}
$_GET:僅包含查詢字串參數。$_POST:僅包含 application/x-www-form-urlencoded 或 multipart/form-data 提交的資料。$_REQUEST:不建議使用,合併 GET/POST/COOKIE,來源不明易導致安全漏洞 (如參數污染)。<?php
function handleUpload(array $file, string $uploadDir, array $allowedMimes, int $maxSize = 5_000_000): array {
// 1. 錯誤碼檢查
if ($file['error'] !== UPLOAD_ERR_OK) {
throw new RuntimeException('上傳錯誤代碼:' . $file['error']);
}
// 2. 檔案大小
if ($file['size'] > $maxSize) {
throw new RuntimeException('檔案過大');
}
// 3. MIME 偵測 (防偽裝副檔名)
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$mime = finfo_file($finfo, $file['tmp_name']);
if (!in_array($mime, $allowedMimes)) {
throw new RuntimeException('檔案類型不允許');
}
// 4. 檔名安全化
$ext = ['image/jpeg'=>'.jpg','image/png'=>'.png','image/webp'=>'.webp'][$mime] ?? '';
$newName = bin2hex(random_bytes(16)) . $ext;
$destPath = $uploadDir . '/' . $newName;
// 5. 移動檔案 (跨分區安全)
if (!move_uploaded_file($file['tmp_name'], $destPath)) {
throw new RuntimeException('檔案移動失敗');
}
return ['path' => $destPath, 'mime' => $mime, 'size' => $file['size']];
}
action="" 會提交到當前頁面,但包含查詢字串時行為不一致,建議明確指定 URL。enctype="multipart/form-data" 僅用於檔案上傳,一般表單用預設 application/x-www-form-urlencoded 即可。$_POST 不包含 JSON 請求主體,需用 file_get_contents('php://input') 讀取並 json_decode()。isset() 或 ?? 處理。name="tags[]" 會自動轉為 PHP 陣列,便於批次處理。表單處理是前後端交互的橋樑,做好驗證、防護、回饋三環節,才能構建安全好用的 Web 應用。建議將驗證邏輯封裝為可復用的 FormRequest/Validator 類別,配合框架機制發揮最大效益。