PHP 提供 9 個「超全域變數」,在所有作用域自動可用,無需 global 宣告。它們承載 HTTP 請求、伺服器環境、會話狀態等關鍵資訊,是 Web 開發的核心資料來源。本文系統整理每個變數的結構、常用鍵值、安全注意事項與實戰範例。
$_SERVER — 伺服器與執行環境資訊包含 HTTP 標頭、路徑、腳本位置等 CGI/Apache 變數。注意:鍵名大小寫不一致視伺服器而定,建議統一用 strtoupper 或 array_change_key_case。
| 鍵名 | 說明 | 範例值 |
|---|---|---|
SERVER_ADDR | 伺服器 IP | 192.168.1.100 |
SERVER_NAME | 伺服器主機名 | example.com |
REQUEST_METHOD | 請求方法 | GET, POST, PUT, DELETE |
REMOTE_ADDR | 客戶端 IP (可能經代理) | 203.0.113.45 |
REMOTE_HOST | 客戶端主機名 (需 DNS 反解) | user.isp.net |
REMOTE_PORT | 客戶端連接埠 | 54321 |
SCRIPT_FILENAME | 當前腳本絕對路徑 | /var/www/html/index.php |
SERVER_PORT | 伺服器監聽埠 | 80, 443 |
SERVER_SIGNATURE | 伺服器版本與虛擬主機資訊 (Apache) | Apache/2.4.41 (Ubuntu) |
DOCUMENT_ROOT | 網站根目錄 | /var/www/html |
HTTP_USER_AGENT | 瀏覽器 UA 字串 | Mozilla/5.0... |
HTTP_REFERER | 來源頁面 (不可信,可偽造) | https://google.com/ |
REQUEST_URI | 請求 URI (含查詢字串) | /search?q=php |
QUERY_STRING | 查詢字串 | q=php&page=2 |
PHP_SELF | 當前腳本相對 DocumentRoot 路徑 | /index.php |
REQUEST_TIME_FLOAT | 請求開始微秒時間戳 (PHP 5.4+) | 1699900000.1234 |
REQUEST_TIME | 請求開始秒級時間戳 | 1699900000 |
function getClientIp() {
$keys = ['HTTP_X_FORWARDED_FOR', 'HTTP_X_REAL_IP', 'HTTP_CLIENT_IP', 'REMOTE_ADDR'];
foreach ($keys as $key) {
if (!empty($_SERVER[$key])) {
$ips = explode(',', $_SERVER[$key]);
return trim($ips[0]); // 取第一個非代理 IP
}
}
return 'unknown';
}
$_GET — URL 查詢字串參數?key=value&foo=barurldecode$_POST — HTTP POST 主體資料application/x-www-form-urlencoded 或 multipart/form-data$_FILES,不在 $_POSTpost_max_size、upload_max_filesize 限制$_COOKIE — HTTP Cookiesetcookie() 設定,瀏覽器自動攜帶setcookie('name', 'val', ['secure' => true, 'httponly' => true, 'samesite' => 'Lax'])$_SESSION — 會話資料session_start()session.cookie_httponly=1, session.use_strict_mode=1, session.cookie_samesite=Lax$_FILES — 上傳檔案資訊$_FILES['fieldName'] = [
'name' => 'original.jpg', // 客戶端檔名
'type' => 'image/jpeg', // MIME (不可信,需伺服端驗證)
'tmp_name' => '/tmp/phpXyz123', // 臨時儲存路徑 (需 move_uploaded_file)
'error' => UPLOAD_ERR_OK, // 錯誤代碼
'size' => 123456, // 位元組數
];
錯誤代碼對照:UPLOAD_ERR_OK=0, UPLOAD_ERR_INI_SIZE=1, UPLOAD_ERR_FORM_SIZE=2, UPLOAD_ERR_PARTIAL=3, UPLOAD_ERR_NO_FILE=4, UPLOAD_ERR_NO_TMP_DIR=6, UPLOAD_ERR_CANT_WRITE=7, UPLOAD_ERR_EXTENSION=8。
$_ENV — 環境變數.env (透過 vlucas/phpdotenv)、Docker -e、K8s ConfigMap$_REQUEST — 合併 GET/POST/COOKIE (不推薦)順序受 request_order (PHP.INI) 控制,預設 GP (GET 後 POST 覆蓋)。安全風險:Cookie 可覆蓋 GET/POST 參數,導致參數注入。明確使用 $_GET/$_POST/$_COOKIE。
$GLOBALS['var'] === $var 在全域作用域$GLOBALS['db'] 存取全域連線物件 (不推薦,優先依賴注入)$_SERVER['HTTP_*'], $_GET, $_POST, $_COOKIE, $_REQUEST — 輸入必須驗證、過濾、轉義。htmlspecialchars($str, ENT_QUOTES, 'UTF-8'),JS 用 json_encode,SQL 用參數化查詢。register_globals=Off (PHP 5.4+ 已移除)、allow_url_include=Off。session_regenerate_id(true) 登入後重新生成 ID,設定 cookie_secure (HTTPS)、cookie_httponly、cookie_samesite。熟練掌握 9 大超全域變數的來源、結構與安全邊界,是 PHP 開發者從「寫出能跑的代碼」進階到「寫出安全、可維護的應用」的關鍵門檻。建議收藏本表,開發時隨查隨用。