萬盛學電腦網

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

PHP 表單處理全攻略:GET/POST 差異、資料驗證與安全防護

表單處理是 Web 開發最基礎也最關鍵的環節。本文系統整理 PHP 處理 GET/POST 請求的差異、資料驗證技巧、安全防護措施與現代最佳實踐,幫助你建立健壯的表單處理機制。

GET vs POST 核心差異

特性GETPOST
資料位置URL 查詢字串 (?key=val)HTTP Request Body
可見性瀏覽器網址列明文可見不直接顯示於網址列
長度限制約 2048 字元 (瀏覽器/伺服器限制)理論無上限 (受 post_max_size 限制)
快取行為可被快取、書籤、分享不會被快取/書籤
歷史紀錄保留在瀏覽歷史不保留參數
資料類型僅 ASCII 字串支援二進位、multipart/form-data (檔案上傳)
適用場景搜尋、分頁、篩選、非敏感資料查詢登入、註冊、修改資料、檔案上傳、敏感操作
安全性低 (易受 CSRF、記錄洩漏)較高 (但仍需 CSRF Token 防護)

基礎表單處理範例

GET 請求:搜尋/查詢場景

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}";

// 實際查詢資料庫...

POST 請求:資料提交場景

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;

現代表單處理最佳實踐

1. PRG 模式

Post-Redirect-Get:POST 處理完成後 302/303 重導向 到 GET 頁面,防止使用者重新整理重複提交。

2. CSRF 防護

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

3. 輸入驗證三層防線

  1. 前端 HTML5 驗證:required, pattern, minlength, type="email/number/url" — 使用者體驗優化,非安全防線。
  2. 後端語法/格式驗證:長度、格式、型別、範圍、白名單驗證。
  3. 業務邏輯驗證:帳號唯一性、權限檢查、狀態流轉合法性。

4. 統一錯誤回應格式 (API 模式)

<?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, $_REQUEST

  • $_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']];
}

常見陷阱提醒

  1. action="" 會提交到當前頁面,但包含查詢字串時行為不一致,建議明確指定 URL。
  2. enctype="multipart/form-data" 僅用於檔案上傳,一般表單用預設 application/x-www-form-urlencoded 即可。
  3. $_POST 不包含 JSON 請求主體,需用 file_get_contents('php://input') 讀取並 json_decode()。
  4. 未勾選的 checkbox/radio 完全不會出現在 $_POST 中,需用 isset() 或 ?? 處理。
  5. 陣列型輸入名稱 name="tags[]" 會自動轉為 PHP 陣列,便於批次處理。

表單處理是前後端交互的橋樑,做好驗證、防護、回饋三環節,才能構建安全好用的 Web 應用。建議將驗證邏輯封裝為可復用的 FormRequest/Validator 類別,配合框架機制發揮最大效益。

copyright © 萬盛學電腦網 all rights reserved