萬盛學電腦網

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

Apache RewriteCond 指令詳細解析:條件判斷、標誌位、實戰重寫規則

Apache mod_rewrite 核心:RewriteCond 條件判斷機制全解析

RewriteCond 是 Apache 重寫引擎的「if 語句」,只有滿足條件才會執行緊隨其後的 RewriteRule。掌握其語法、變量、標誌位與匹配邏輯,是實現靈活 URL 重寫、防盜鏈、域名跳轉、HTTPS 強制等需求的關鍵。

基本語法

RewriteCond TestString CondPattern [flags]
  • TestString:被測試字符串,可包含服務器變量(%{VAR})、映射查找、反向引用等。
  • CondPattern:正則表達式(PCRE)或特殊匹配模式。
  • flags:修飾符,如 [NC] (忽略大小寫)、[OR] (邏輯或)、[NV] (無變體) 等。

常用 TestString 變量速查

變量含義示例值
%{HTTP_HOST}請求 Host 頭www.example.com
%{HTTP_REFERER}來源頁面 URLhttps://google.com/search?q=test
%{HTTP_USER_AGENT}用戶代理字符串Mozilla/5.0 ...
%{REMOTE_ADDR}客戶端 IP192.168.1.100
%{REQUEST_URI}請求 URI(不含查詢串)/path/to/page
%{QUERY_STRING}查詢字符串id=123&type=json
%{REQUEST_FILENAME}映射到文件系統的完整路徑/var/www/html/path/to/page
%{HTTPS}是否 HTTPS (on/off)on
%{SERVER_PORT}服務器端口443
%{TIME_YEAR}, %{TIME_MON}...服務器時間組件2024, 05

CondPattern 特殊匹配模式(非正則)

模式含義
'' (lexicographic)字典序比較:' (小於)、'>value' (大於)、'=value' (等於)
-d測試路徑是否為存在的目錄
-f測試路徑是否為存在的普通文件
-s測試文件是否存在且大小 > 0
-l測試是否為符號鏈接
-F子請求檢查文件是否可訪問(性能慎用)
-U / -URL子請求檢查 URL 是否可訪問

關鍵標誌位

標誌全稱作用
NCNoCase忽略大小寫匹配
OROrNext將多條 RewriteCond 以邏輯 OR 連接(默認 AND)
NVNoVary防止該條件導致 Vary 頭添加,提升緩存命中
NENoEscape防止重寫結果中特殊字符被十六進制轉義

實戰案例解析

案例 1:根據 User-Agent 服務不同版本頁面

RewriteEngine On
# 移動端 UA 片段
RewriteCond %{HTTP_USER_AGENT} (iPhone|Android.*Mobile|Windows Phone) [NC]
RewriteRule ^index\.php$ /mobile/index.php [L]

# PC 端
RewriteCond %{HTTP_USER_AGENT} !(iPhone|Android.*Mobile|Windows Phone) [NC]
RewriteRule ^index\.php$ /desktop/index.php [L]

等效 PHP 邏輯:

if (preg_match('/(iPhone|Android.*Mobile|Windows Phone)/i', $_SERVER['HTTP_USER_AGENT'])) {
    // 移動端
} else {
    // PC 端
}

案例 2:防盜鏈(僅允許特定域名引用圖片)

RewriteEngine On
# 允許空 Referer (直接訪問/書籤) 和 自域名/合作夥伴域名
RewriteCond %{HTTP_REFERER} !^$ [NC]
RewriteCond %{HTTP_REFERER} !^https?://(www\.)?example\.com [NC]
RewriteCond %{HTTP_REFERER} !^https?://(www\.)?partner\.com [NC]
# 匹配圖片請求
RewriteRule \.(jpg|jpeg|png|gif|webp)$ /static/images/hotlink-denied.png [NC,R,L]

案例 3:多域名/多主機條件 OR 邏輯

RewriteCond %{HTTP_HOST} ^site1\.example\.com$ [NC,OR]
RewriteCond %{HTTP_HOST} ^site2\.example\.com$ [NC,OR]
RewriteCond %{HTTP_HOST} ^site3\.example\.com$ [NC]
RewriteRule ^(.*)$ https://main.example.com/$1 [R=301,L]

等效:if (host==site1 OR host==site2 OR host==site3) redirect

案例 4:靜態文件存在直接服務,否則轉發 PHP(前端控制器模式)

RewriteEngine On
# 如果請求文件存在,直接服務(不重寫)
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# 否則重寫到 index.php
RewriteRule ^ index.php [L]

這是 Laravel/ThinkPHP/Symfony 等框架入口文件的標準配置核心。

案例 5:強制 HTTPS + 統一 www

RewriteEngine On
# 1. 強制 HTTPS
RewriteCond %{HTTPS} off
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L,NE]

# 2. 統一 www (可選)
RewriteCond %{HTTP_HOST} ^example\.com$ [NC]
RewriteRule ^ https://www.example.com%{REQUEST_URI} [R=301,L,NE]

案例 6:基於時間的訪問控制(如維護窗口)

# 每天 02:00-04:00 進入維護頁
RewriteCond %{TIME_HOUR} 0[23] [OR]
RewriteCond %{TIME_HOUR} 04
RewriteCond %{REQUEST_URI} !^/maintenance\.php$
RewriteRule ^ /maintenance.php [L]

調試技巧

  1. 開啟重寫日誌(Apache 2.4+):LogLevel alert rewrite:trace3(僅調試時開啟,生產嚴禁)。
  2. RewriteLog (舊版) 已廢棄,改用 ErrorLog 中的 rewrite: 通道。
  3. 在線測試工具:htaccess tester、Regex Tester。

性能與安全最佳實踐

  • 將通用規則放在 httpd.conf / VirtualHost,避免 .htaccess 多級目錄遍歷開銷。
  • 使用 -f/-d 文件存在檢查代替正則匹配擴展名,效率更高。
  • 避免過度複雜的正則,優先使用精確字符串匹配。
  • [NV] 標誌防止 Vary 頭污染緩存鍵(CDN/Proxy 緩存關鍵)。
  • 重定向 (R=301/302) 必加 [L] 終止後續規則,並用 [NE] 保持特殊字符不轉義。
copyright © 萬盛學電腦網 all rights reserved