萬盛學電腦網

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

PHP $_POST 超全域變數詳細教學:表單資料接收與安全處理實務

$_POST 是 PHP 內建超全域陣列,接收 Content-Type: application/x-www-form-urlencoded 或 multipart/form-data 的 HTTP POST 請求主體資料。本文詳細說明特性、處理流程、安全防護與檔案上傳整合。

運作機制

<form action="welcome.php" method="post">
    Name: <input type="text" name="name" />
    Age: <input type="text" name="age" />
    <input type="submit" />
</form>

提交後 URL 不包含 表單資料:

https://example.com/welcome.php

PHP 解析請求主體:

<?php
// $_POST = ['name' => 'Peter', 'age' => '37'];
echo $_POST['name']; // Peter
echo $_POST['age'];  // 37
?>

$_POST 核心特性

特性說明
可見性URL 不顯示參數(但可被開發者工具/抓包工具檢視)
資料長度受 post_max_size(預設 8M)限制
書籤/分享不可直接書籤 POST 頁面
重新整理瀏覽器警告「重新提交表單」,需 PRG 模式解決
編碼格式application/x-www-form-urlencoded(預設)或 multipart/form-data(檔案上傳)
陣列支援name[]=a&name[]=b → $_POST['name'] = ['a','b']

適用場景

  • 用戶登入/註冊(密碼、敏感資料)
  • 資料新增/修改/刪除(非冪等操作)
  • 檔案上傳(需 enctype="multipart/form-data")
  • 大量文字內容提交(文章發布、評論)
  • 付款/訂單提交等交易操作

安全處理實務

1. 請求方法驗證

<?php
// 僅處理 POST 請求
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    http_response_code(405); // Method Not Allowed
    die('僅接受 POST 請求');
}
?>

2. CSRF 令牌驗證(必要)

<?php
session_start();

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

// 表單嵌入
// <input type="hidden" name="csrf_token" value="">

// 驗證
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $token = $_POST['csrf_token'] ?? '';
    if (!hash_equals($_SESSION['csrf_token'], $token)) {
        http_response_code(403);
        die('CSRF 驗證失敗,請重新提交');
    }
    // 繼續處理...
}
?>

3. 輸入過濾與驗證

<?php
// 使用 filter_input 系列(自動處理不存在鍵)
$email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);
$age = filter_input(INPUT_POST, 'age', FILTER_VALIDATE_INT, [
    'options' => ['min_range' => 1, 'max_range' => 120]
]);
$name = filter_input(INPUT_POST, 'name', FILTER_SANITIZE_SPECIAL_CHARS);

// 手動驗證邏輯
$errors = [];
if ($email === false) $errors[] = 'Email 格式錯誤';
if ($age === false || $age === null) $errors[] = '年齡必須為 1-120 整數';
if (empty($name)) $errors[] = '姓名不可為空';

if ($errors) {
    // 回傳錯誤(AJAX 回傳 JSON,傳統表單重導回帶錯誤訊息)
    die(implode('<br>', $errors));
}
?>

4. 輸出編碼(防 XSS)

<?php
// 重新顯示用戶輸入時必須編碼
function h(string $str): string {
    return htmlspecialchars($str, ENT_QUOTES, 'UTF-8');
}

echo '<input value="' . h($_POST['name'] ?? '') . '">';
echo '<textarea>' . h($_POST['comment'] ?? '') . '</textarea>';
?>

檔案上傳:$_FILES 整合

<form action="upload.php" method="post" enctype="multipart/form-data">
    <input type="file" name="avatar" accept="image/*" />
    <input type="submit" />
</form>
<?php
// upload.php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // CSRF 驗證...
    
    $file = $_FILES['avatar'] ?? null;
    if (!$file || $file['error'] !== UPLOAD_ERR_OK) {
        die('上傳失敗:' . ($file['error'] ?? '未知錯誤'));
    }
    
    // 安全驗證
    $allowedTypes = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $mime = finfo_file($finfo, $file['tmp_name']);
    
    if (!in_array($mime, $allowedTypes, true)) {
        die('不支援的檔案類型');
    }
    
    if ($file['size'] > 2 * 1024 * 1024) { // 2MB
        die('檔案過大,限制 2MB');
    }
    
    // 安全儲存:隨機檔名 + 儲存於非公開目錄
    $ext = match ($mime) {
        'image/jpeg' => '.jpg',
        'image/png' => '.png',
        'image/gif' => '.gif',
        'image/webp' => '.webp',
    };
    $newName = bin2hex(random_bytes(16)) . $ext;
    $destPath = __DIR__ . '/../storage/uploads/' . $newName;
    
    if (move_uploaded_file($file['tmp_name'], $destPath)) {
        echo "上傳成功:$newName";
    } else {
        die('檔案移動失敗');
    }
}
?>

PRG 模式:解決重新整理重複提交

<?php
// process.php
session_start();

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 1. 驗證 CSRF、輸入資料...
    
    // 2. 業務邏輯處理
    $success = saveArticle($_POST);
    
    // 3. 將結果存入 Session(閃存訊息)
    $_SESSION['flash'] = $success ? '發布成功' : '發布失敗';
    
    // 4. 重導向到 GET 頁面
    header('Location: article_list.php');
    exit;
}
?>
<?php
// article_list.php
session_start();
if (!empty($_SESSION['flash'])) {
    echo '<div class="alert">' . htmlspecialchars($_SESSION['flash']) . '</div>';
    unset($_SESSION['flash']); // 閃存只顯示一次
}
?>
✅ 核心原則: 永不信任用戶輸入。所有 $_POST 資料視為污染資料,經過:驗證 → 過濾/轉換 → 業務處理 → 輸出編碼。使用框架表單組件/驗證器可大幅降低疏漏風險。
copyright © 萬盛學電腦網 all rights reserved