PHP $_SERVER 超全局變數完整指南：從基礎應用到代理穿透實戰

前言

$_SERVER 是 PHP 核心超全局變數，包含請求、服務器、腳本運行環境等關鍵信息。本文系統整理所有鍵值含義，重點解析 HTTP_X_FORWARDED_HOST 代理穿透實戰應用。

一、核心變數分類速查表

1. 腳本與請求基礎信息

2. 服務器與協議信息

3. 客戶端與請求頭信息

4. 客戶端網絡信息

5. HTTP 認證相關（Apache 模塊模式）

二、重點實戰：HTTP_X_FORWARDED_HOST 代理穿透

1. 背景問題

通過代理/CDN/負載均衡訪問時，REMOTE_ADDR 獲取到的是代理 IP，非真實客戶端 IP。

2. 關鍵變數對比

3. 獲取真實 IP 最佳實踐

<?php
function getRealClientIp() {
    $ipKeys = [
        'HTTP_X_REAL_IP',        // Nginx 代理首選
        'HTTP_X_FORWARDED_FOR',  // 標準代理頭
        'HTTP_CLIENT_IP',        // 部分代理
        'REMOTE_ADDR'            // 直連或兜底
    ];
    
    foreach ($ipKeys as $key) {
        if (!empty($_SERVER[$key])) {
            // X-Forwarded-For 可能包含多個 IP，取第一個
            $ips = explode(',', $_SERVER[$key]);
            return trim($ips[0]);
        }
    }
    return 'unknown';
}

// 獲取原始 Host（含代理情況）
$host = isset($_SERVER['HTTP_X_FORWARDED_HOST']) 
    ? $_SERVER['HTTP_X_FORWARDED_HOST'] 
    : (isset($_SERVER['HTTP_HOST']) ? $_SERVER['HTTP_HOST'] : '');
?>

4. 安全警示

• 不可完全信任：HTTP 頭可被客戶端偽造
• 需配合代理配置：Nginx proxy_set_header X-Real-IP $remote_addr;
• 內網環境優先：僅在可信代理鏈路中使用
• 日誌記錄雙重記錄：同時記錄 REMOTE_ADDR 和解析出的真實 IP

三、文檔根目錄與路徑處理

<?php
// 文檔根目錄（Apache DocumentRoot）
$docRoot = $_SERVER['DOCUMENT_ROOT'];  // /var/www/html

// 當前腳本文件系統路徑（非文檔根目錄）
$pathTranslated = $_SERVER['PATH_TRANSLATED'];  // /var/www/html/index.php

// 當前腳本 URL 路徑
$scriptName = $_SERVER['SCRIPT_NAME'];  // /index.php
?>

四、調試技巧：快速查看所有 $_SERVER

<?php
echo '<pre>';
print_r($_SERVER);
echo '</pre>';
// 或僅顯示鍵名
echo implode(', ', array_keys($_SERVER));
?>

掌握 $_SERVER 細節，能精準處理路由、代理穿透、安全防禦、多環境部署等核心場景。