萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Nginx + PHP 環境下 SERVER_NAME 與 HTTP_HOST 差異深度解析

核心差異速查

變數來源行為可信度
$_SERVER['SERVER_NAME']Nginx fastcgi_param SERVER_NAME 設定值 (通常對應 server_name 第一個值)由伺服器端設定決定,不受客戶端影響高 (伺服器可控)
$_SERVER['HTTP_HOST']客戶端請求標頭 Host反映用戶實際請求的域名/IP:Port中 (客戶端可偽造)

Nginx 設定範例

server {
    listen 80;
    server_name www.example.com example.com;  # 多個 domain

    location ~ \.php$ {
        fastcgi_param SERVER_NAME $server_name;  # 取第一個: www.example.com
        fastcgi_param HTTP_HOST $http_host;      # 透傳客戶端 Host 標頭
        # ... 其他 fastcgi_param
    }
}

三種情境對照

情境 1:標準 HTTPS/HTTP (Port 80/443)、ServerName 設定正確、HTTP/1.1

  • SERVER_NAME = www.example.com
  • HTTP_HOST = www.example.com
  • → 兩者相同

情境 2:非標準 Port (如 8080)

  • 請求:https://www.example.com:8080/
  • HTTP_HOST = www.example.com:8080 (含 Port)
  • SERVER_NAME = www.example.com (不含 Port)
  • → 兩者不同

情境 3:Nginx 未設定 server_name 或 IP 直接存取

  • SERVER_NAME 可能為空或預設值 (如 _、localhost)
  • HTTP_HOST = 客戶端請求的 IP 或域名
  • → 兩者不同

實務建議:優先使用 HTTP_HOST (但需驗證)

<?php
// 取得當前完整 URL (含協定、域名、Port、URI)
$scheme = (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] !== 'off') ? 'https' : 'http';
$host   = $_SERVER['HTTP_HOST'];  // 含 port
$uri    = $_SERVER['REQUEST_URI'];
$currentUrl = $scheme . '://' . $host . $uri;

// 安全驗證:白名單機制
$allowedHosts = ['www.example.com', 'example.com', 'api.example.com'];
if (!in_array($_SERVER['HTTP_HOST'], $allowedHosts, true)) {
    // 非預期 Host,記錄日誌、導向標準域名或拒絕
    header('Location: https://www.example.com' . $uri, true, 301);
    exit;
}
?>

進階:信任代理伺服器 (Cloudflare, Load Balancer)

若架構在反向代理後方,HTTP_HOST 可能被代理改寫。需設定信任代理並讀取 X-Forwarded-Host:

<?php
// 信任特定代理 IP
$trustedProxies = ['10.0.0.1', '192.168.1.100'];
$clientIp = $_SERVER['REMOTE_ADDR'];

if (in_array($clientIp, $trustedProxies, true)) {
    $host = $_SERVER['HTTP_X_FORWARDED_HOST'] ?? $_SERVER['HTTP_HOST'];
} else {
    $host = $_SERVER['HTTP_HOST'];
}
?>

結語

  • SERVER_NAME:伺服器端定義的權威名稱,適合產生 canonical URL、信任度高。
  • HTTP_HOST:客戶端實際請求的 Host,含 Port 資訊,適合多域名共用代碼、重導向邏輯,但必須驗證白名單防止 Host Header Injection 攻擊。
  • 最佳實踐:結合兩者,以 SERVER_NAME 為基準,HTTP_HOST 為參考並驗證。
copyright © 萬盛學電腦網 all rights reserved