PHP $_SERVER 判斷 Rewrite 模式：Apache vs IIS (ISAPI) 環境識別與 301 統一入口實戰

核心差異：環境變量映射表

統一獲取「用戶看到的 URL」函數

<?php
/**
 * 獲取用戶瀏覽器地址欄顯示的 URL（含查詢字串）
 * 兼容 Apache mod_rewrite、IIS ISAPI_Rewrite、Nginx、無重寫
 */
function getDisplayUrl(): string {
    // 1. ISAPI_Rewrite (IIS)
    if (isset($_SERVER['HTTP_X_REWRITE_URL'])) {
        return $_SERVER['HTTP_X_REWRITE_URL'];
    }
    // 2. Apache mod_rewrite
    if (isset($_SERVER['REDIRECT_URL'])) {
        $url = $_SERVER['REDIRECT_URL'];
        if (isset($_SERVER['REDIRECT_QUERY_STRING'])) {
            $url .= '?' . $_SERVER['REDIRECT_QUERY_STRING'];
        }
        return $url;
    }
    // 3. Nginx + PHP-FPM (通常無 REDIRECT_* 變量)
    // 4. 普通請求
    return $_SERVER['REQUEST_URI'] ?? '/';
}

實戰：動態參數 URL 301 導向靜態化 URL

需求：/article.php?id=123 → /article/123.html

<?php
// 入口文件最頂部執行
$displayUrl = getDisplayUrl();

// 判斷是否為舊式動態參數 URL
if (preg_match('#^/article\.php\?id=(\d+)$#', $displayUrl, $matches)) {
    $id = (int)$matches[1];
    if ($id > 0) {
        $newUrl = "/article/{$id}.html";
        header('HTTP/1.1 301 Moved Permanently');
        header('Location: ' . $newUrl);
        exit;
    }
}

// 正常路由分發...

避免無限重定向循環

關鍵在於只在「舊格式」時重定向，新格式直接進入路由：

<?php
// 檢測是否已經是靜態化 URL
if (preg_match('#^/article/\d+\.html$#', $displayUrl)) {
    // 已是新格式，正常處理
    return;
}
// 否則嘗試從舊格式轉換...

Nginx + PHP-FPM 特別說明

Nginx 不會產生 REDIRECT_* 變量，REQUEST_URI 即為重寫後的 URL。若需獲取原始未重寫 URL，需在 Nginx 配置中額外傳遞：

# nginx.conf
location / {
    try_files $uri $uri/ /index.php?$query_string;
    # 額外傳遞原始 URI
    fastcgi_param ORIGINAL_URI $request_uri;
}

<?php
// PHP 端讀取
$originalUri = $_SERVER['ORIGINAL_URI'] ?? $_SERVER['REQUEST_URI'];

快速環境檢測工具

<?php
function detectRewriteEnv(): array {
    return [
        'is_apache_rewrite'  => isset($_SERVER['REDIRECT_URL']),
        'is_iis_isapi'       => isset($_SERVER['HTTP_X_REWRITE_URL']),
        'is_nginx'           => strpos($_SERVER['SERVER_SOFTWARE'] ?? '', 'nginx') !== false,
        'display_url'        => getDisplayUrl(),
        'request_uri'        => $_SERVER['REQUEST_URI'] ?? '',
        'server_software'    => $_SERVER['SERVER_SOFTWARE'] ?? 'unknown',
    ];
}
print_r(detectRewriteEnv());