在撰寫跨平台 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';
}
| 變數名稱 | 出現環境 | 說明 |
|---|---|---|
| HTTP_X_REWRITE_URL | IIS 7+ (整合模式) | URL Rewrite 模組設定的原始重寫路徑 |
| ORIG_PATH_INFO | IIS 5/6 (CGI/FastCGI) | 原始 PATH_INFO,常用於舊版 IIS 判斷 |
| SERVER_SOFTWARE | 所有 | 含 "Apache" 或 "Microsoft-IIS" 字樣,最通用判斷依據 |
| REDIRECT_URL | Apache (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';
}
SERVER_SOFTWARE 可被偽造或隱藏(安全設定),建議結合多個指標判斷SERVER_SOFTWARE 通常顯示 "nginx"HTTP_X_FORWARDED_SERVER 等標頭原文提到的判斷邏輯源自 Yii 框架核心代碼,證明其在實際專案中的可靠性。現代框架(Laravel, Symfony)通常已內建抽象層,開發者較少需直接判斷 Server 類型。