前言
$_SERVER 是 PHP 最重要的超全域陣列之一,包含 HTTP 請求、伺服器環境、腳本路徑等關鍵資訊。本文系統分類 40+ 常用鍵值,提供實戰範例與安全應用指南。
一、分類速查表
1. 請求與頁面相關
| 鍵名 | 說明 | 範例值 |
| PHP_SELF | 當前腳本路徑 (相對 DocumentRoot) | /index.php |
| SCRIPT_NAME | 同 PHP_SELF,但更標準 | /index.php |
| REQUEST_URI | 完整請求 URI (含查詢字串) | /index.php?page=1&sort=desc |
| QUERY_STRING | 查詢字串 (不含 ?) | page=1&sort=desc |
| REQUEST_METHOD | HTTP 方法 | GET, POST, PUT, DELETE |
| argv | 命令列參數陣列 | ['arg1', 'arg2'] |
| argc | 命令列參數個數 | 2 |
| REQUEST_TIME | 請求開始時間戳 (PHP 5.1+) | 1700000000 |
| REQUEST_TIME_FLOAT | 微秒精度時間戳 (PHP 5.4+) | 1700000000.1234 |
2. HTTP 標頭資訊 (Client → Server)
| 鍵名 | 對應 HTTP 標頭 | 範例 |
| HTTP_HOST | Host | example.com:8080 |
| HTTP_REFERER | Referer | https://google.com/search?q=php |
| HTTP_USER_AGENT | User-Agent | Mozilla/5.0... Chrome/120 |
| HTTP_ACCEPT | Accept | text/html,application/xhtml+xml |
| HTTP_ACCEPT_LANGUAGE | Accept-Language | zh-TW,zh;q=0.9,en;q=0.8 |
| HTTP_ACCEPT_ENCODING | Accept-Encoding | gzip, deflate, br |
| HTTP_ACCEPT_CHARSET | Accept-Charset | utf-8, iso-8859-1 |
| HTTP_CONNECTION | Connection | keep-alive |
| HTTP_AUTHORIZATION | Authorization | Bearer xyz123 |
| HTTP_COOKIE | Cookie | session_id=abc; user=tom |
| HTTP_X_FORWARDED_FOR | X-Forwarded-For (代理) | 203.0.113.195, 70.41.3.18 |
| HTTP_X_REAL_IP | X-Real-IP (Nginx 代理) | 203.0.113.195 |
3. 伺服器與執行環境
| 鍵名 | 說明 | 範例 |
| SERVER_SOFTWARE | 伺服器軟體版本 | nginx/1.24.0 / Apache/2.4.58 |
| SERVER_NAME | 伺服器主機名 (VirtualHost) | example.com |
| SERVER_ADDR | 伺服器 IP | 192.168.1.100 |
| SERVER_PORT | 伺服器埠號 | 80, 443, 8080 |
| SERVER_PROTOCOL | HTTP 協議版本 | HTTP/1.1, HTTP/2.0 |
| SERVER_ADMIN | 管理員 Email (Apache 設定) | admin@example.com |
| SERVER_SIGNATURE | 伺服器簽名 (錯誤頁面用) | Apache/2.4.58 (Ubuntu) Server at... |
| GATEWAY_INTERFACE | CGI 規範版本 | CGI/1.1 |
| DOCUMENT_ROOT | 網站根目錄絕對路徑 | /var/www/html |
| SCRIPT_FILENAME | 當前腳本絕對路徑 | /var/www/html/index.php |
| PATH_TRANSLATED | 檔案系統路徑 (非 DocumentRoot) | /var/www/html/index.php |
4. HTTPS 與認證
| 鍵名 | 說明 |
| HTTPS | 非空值表示 HTTPS (通常 'on') |
| SSL_TLS_SNI | SNI 主機名 (PHP 7.3+) |
| PHP_AUTH_USER | HTTP Basic Auth 用戶名 |
| PHP_AUTH_PW | HTTP Basic Auth 密碼 |
| PHP_AUTH_DIGEST | HTTP Digest Auth 標頭內容 |
| AUTH_TYPE | 認證類型 (Basic/Digest) |
5. 客戶端資訊
| 鍵名 | 說明 |
| REMOTE_ADDR | 客戶端 IP (可能為代理 IP) |
| REMOTE_HOST | 客戶端主機名 (需 DNS 反解) |
| REMOTE_PORT | 客戶端來源埠號 |
| REMOTE_USER | 經認證的用戶名 (Apache 模組) |
二、關鍵差異辨析
PHP_SELF vs SCRIPT_NAME vs REQUEST_URI
// URL: https://example.com/index.php?foo=bar
$_SERVER['PHP_SELF'] = '/index.php';
$_SERVER['SCRIPT_NAME'] = '/index.php';
$_SERVER['REQUEST_URI'] = '/index.php?foo=bar';
$_SERVER['QUERY_STRING'] = 'foo=bar';
// 重寫規則下 (URL: https://example.com/user/profile)
$_SERVER['SCRIPT_NAME'] = '/index.php'; // 實際腳本
$_SERVER['REQUEST_URI'] = '/user/profile'; // 美化後 URL
$_SERVER['PHP_SELF'] = '/index.php'; // 同 SCRIPT_NAME
建議:表單 action 用 SCRIPT_NAME,重導向/生成連結用 REQUEST_URI。
取得真實客戶端 IP (反向代理環境)
function getClientIp(): string {
$keys = [
'HTTP_X_FORWARDED_FOR', // 可能包含多個 IP,取第一個
'HTTP_X_REAL_IP', // Nginx proxy_set_header
'HTTP_CLIENT_IP', // 部分代理
'REMOTE_ADDR', // 直連
];
foreach ($keys as $key) {
if (!empty($_SERVER[$key])) {
$ips = explode(',', $_SERVER[$key]);
return trim($ips[0]);
}
}
return 'unknown';
}
三、安全應用指南
1. 防止 Host Header 攻擊
$allowedHosts = ['example.com', 'www.example.com'];
$host = $_SERVER['HTTP_HOST'] ?? $_SERVER['SERVER_NAME'];
if (!in_array($host, $allowedHosts, true)) {
http_response_code(400);
exit('Invalid Host header');
}
2. 安全重導向 (防開放重導向)
$redirect = $_GET['redirect'] ?? '/';
// 驗證同域或白名單
if (str_starts_with($redirect, '/') && !str_starts_with($redirect, '//')) {
header("Location: $redirect");
exit;
}
3. CSP Nonce 產生
$nonce = base64_encode(random_bytes(16));
header("Content-Security-Policy: script-src 'nonce-$nonce';");
// 模板中:
4. CLI 環境下的 $_SERVER
CLI 模式下大多 HTTP_* 鍵不存在,REQUEST_METHOD 為空,argv/argc 可用。
四、實用工具函數
// 取得完整 URL
function getCurrentUrl(): string {
$scheme = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
$host = $_SERVER['HTTP_HOST'] ?? $_SERVER['SERVER_NAME'];
$uri = $_SERVER['REQUEST_URI'] ?? '';
return $scheme . '://' . $host . $uri;
}
// 判斷 AJAX 請求
function isAjax(): bool {
return (isset($_SERVER['HTTP_X_REQUESTED_WITH'])
&& strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest');
}
// 判斷 HTTPS
function isHttps(): bool {
return (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off')
|| ($_SERVER['SERVER_PORT'] ?? 80) === 443;
}
總結
$_SERVER 是 PHP 與 Web 伺服器溝通的橋樑。熟悉各鍵值含義、差異與安全風險,能編寫更健壯的路由、認證、日誌、防禦系統。記住:所有 HTTP_* 值皆來自用戶端,不可信任,必須驗證清洗後使用。