$_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
?>
| 特性 | 說明 |
|---|---|
| 可見性 | 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")<?php
// 僅處理 POST 請求
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
http_response_code(405); // Method Not Allowed
die('僅接受 POST 請求');
}
?>
<?php
session_start();
// 產生 Token
if (empty($_SESSION['csrf_token'])) {
$_SESSION['csrf_token'] = bin2hex(random_bytes(32));
}
// 表單嵌入
// <input type="hidden" name="csrf_token" value="= htmlspecialchars($_SESSION['csrf_token']) ?>">
// 驗證
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
$token = $_POST['csrf_token'] ?? '';
if (!hash_equals($_SESSION['csrf_token'], $token)) {
http_response_code(403);
die('CSRF 驗證失敗,請重新提交');
}
// 繼續處理...
}
?>
<?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));
}
?>
<?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>';
?>
<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('檔案移動失敗');
}
}
?>
<?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']); // 閃存只顯示一次
}
?>