PHP $_SERVER 超全局變量完整圖鑑：30+ 關鍵鍵值實戰速查

$_SERVER 核心作用

包含 HTTP 頭、腳本路徑、服務器信息、請求元數據等關鍵環境變量，是 Web 開發中獲取請求上下文的核心入口。

高頻使用鍵值分類速查

安全與可靠性關鍵提醒

• HTTP_* 頭可偽造：HTTP_X_FORWARDED_FOR、HTTP_REFERER、HTTP_USER_AGENT 皆不可信
• 真實 IP 獲取：需配合受信代理配置（如 Nginx real_ip_header、set_real_ip_from）
• CLI 模式差異：無 HTTP_*、REQUEST_URI 等 Web 專屬鍵
• 大小寫敏感：鍵名區分大小寫，標準為大寫

實用封裝：Request 類雛形

<?php
class ServerRequest
{
    public function getClientIp(): string
    {
        // 遞歸檢查代理頭（需配置受信代理列表）
        foreach (['HTTP_CF_CONNECTING_IP', 'HTTP_X_FORWARDED_FOR', 'REMOTE_ADDR'] as $key) {
            if (!empty($_SERVER[$key])) {
                $ips = array_map('trim', explode(',', $_SERVER[$key]));
                return $ips[0];
            }
        }
        return 'unknown';
    }

    public function isHttps(): bool
    {
        return (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off')
            || ($_SERVER['SERVER_PORT'] ?? 80) === 443;
    }

    public function getBaseUrl(): string
    {
        $scheme = $this->isHttps() ? 'https' : 'http';
        $host = $_SERVER['HTTP_HOST'] ?? $_SERVER['SERVER_NAME'] ?? 'localhost';
        return $scheme . '://' . $host;
    }
}

調試輸出所有可用鍵值

<?php
// 僅開發環境使用
echo '<pre>';
print_r($_SERVER);
echo '</pre>';