RewriteCond 是 Apache 重寫引擎的「if 語句」,只有滿足條件才會執行緊隨其後的 RewriteRule。掌握其語法、變量、標誌位與匹配邏輯,是實現靈活 URL 重寫、防盜鏈、域名跳轉、HTTPS 強制等需求的關鍵。
RewriteCond TestString CondPattern [flags]
%{VAR})、映射查找、反向引用等。[NC] (忽略大小寫)、[OR] (邏輯或)、[NV] (無變體) 等。| 變量 | 含義 | 示例值 |
|---|---|---|
| %{HTTP_HOST} | 請求 Host 頭 | www.example.com |
| %{HTTP_REFERER} | 來源頁面 URL | https://google.com/search?q=test |
| %{HTTP_USER_AGENT} | 用戶代理字符串 | Mozilla/5.0 ... |
| %{REMOTE_ADDR} | 客戶端 IP | 192.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 |
| 模式 | 含義 |
|---|---|
| ' | 字典序比較:' |
| -d | 測試路徑是否為存在的目錄 |
| -f | 測試路徑是否為存在的普通文件 |
| -s | 測試文件是否存在且大小 > 0 |
| -l | 測試是否為符號鏈接 |
| -F | 子請求檢查文件是否可訪問(性能慎用) |
| -U / -URL | 子請求檢查 URL 是否可訪問 |
| 標誌 | 全稱 | 作用 |
|---|---|---|
| NC | NoCase | 忽略大小寫匹配 |
| OR | OrNext | 將多條 RewriteCond 以邏輯 OR 連接(默認 AND) |
| NV | NoVary | 防止該條件導致 Vary 頭添加,提升緩存命中 |
| NE | NoEscape | 防止重寫結果中特殊字符被十六進制轉義 |
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 端
}
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]
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
RewriteEngine On
# 如果請求文件存在,直接服務(不重寫)
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]
# 否則重寫到 index.php
RewriteRule ^ index.php [L]
這是 Laravel/ThinkPHP/Symfony 等框架入口文件的標準配置核心。
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]
# 每天 02:00-04:00 進入維護頁
RewriteCond %{TIME_HOUR} 0[23] [OR]
RewriteCond %{TIME_HOUR} 04
RewriteCond %{REQUEST_URI} !^/maintenance\.php$
RewriteRule ^ /maintenance.php [L]
LogLevel alert rewrite:trace3(僅調試時開啟,生產嚴禁)。ErrorLog 中的 rewrite: 通道。httpd.conf / VirtualHost,避免 .htaccess 多級目錄遍歷開銷。-f/-d 文件存在檢查代替正則匹配擴展名,效率更高。[NV] 標誌防止 Vary 頭污染緩存鍵(CDN/Proxy 緩存關鍵)。[L] 終止後續規則,並用 [NE] 保持特殊字符不轉義。