萬盛學電腦網

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

PHP 偵測伺服器環境:Apache 或 IIS 的實用判斷技巧

快速識別 PHP 執行環境:Apache vs IIS

在撰寫跨平台 PHP 應用時,常需根據 Web 伺服器類型調整路由、重寫規則或快取策略。本文整理實務上常用的環境偵測方法,並說明各指標的適用場景。

核心判斷邏輯

if (isset($_SERVER['HTTP_X_REWRITE_URL'])) {
    // IIS(含 IIS 7+ 整合管線模式)
    $server = 'IIS';
} elseif (isset($_SERVER['ORIG_PATH_INFO'])) {
    // IIS 5.0 / 6.0 CGI 模式
    $server = 'IIS (CGI)';
} else {
    // 預設視為 Apache 或其他
    $server = 'Apache / Other';
}

關鍵 $_SERVER 變數對照表

變數名稱出現環境說明
HTTP_X_REWRITE_URLIIS 7+ (整合模式)URL Rewrite 模組設定的原始重寫路徑
ORIG_PATH_INFOIIS 5/6 (CGI/FastCGI)原始 PATH_INFO,常用於舊版 IIS 判斷
SERVER_SOFTWARE所有含 "Apache" 或 "Microsoft-IIS" 字樣,最通用判斷依據
REDIRECT_URLApache (mod_rewrite)重寫後的實際請求路徑

更健壯的通用判斷函式

function detect_web_server() {
    $software = $_SERVER['SERVER_SOFTWARE'] ?? '';
    
    if (stripos($software, 'IIS') !== false) {
        return 'IIS';
    }
    if (stripos($software, 'Apache') !== false) {
        return 'Apache';
    }
    if (isset($_SERVER['HTTP_X_REWRITE_URL'])) {
        return 'IIS (Rewrite)';
    }
    if (isset($_SERVER['ORIG_PATH_INFO'])) {
        return 'IIS (CGI)';
    }
    return 'Unknown';
}

實際應用場景

  • URL 重寫規則載入:Apache 讀 .htaccess,IIS 讀 web.config
  • PATH_INFO 解析差異:IIS CGI 模式需手動處理 PATH_INFO
  • 靜態檔案快取策略:不同伺服器的 Expires/Header 設定方式不同
  • 權限與執行身分:IIS 通常用 Application Pool 身分,Apache 用 www-data/apache

注意事項

  1. SERVER_SOFTWARE 可被偽造或隱藏(安全設定),建議結合多個指標判斷
  2. Nginx + PHP-FPM 環境下,SERVER_SOFTWARE 通常顯示 "nginx"
  3. 容器化部署(Docker/K8s)中,實際 Web Server 可能被 Proxy 隱藏,需檢查 HTTP_X_FORWARDED_SERVER 等標頭

Yii 框架實務參考

原文提到的判斷邏輯源自 Yii 框架核心代碼,證明其在實際專案中的可靠性。現代框架(Laravel, Symfony)通常已內建抽象層,開發者較少需直接判斷 Server 類型。

copyright © 萬盛學電腦網 all rights reserved