萬盛學電腦網

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

Apache mod_rewrite 實現 PHP 偽靜態完整配置指南

什麼是偽靜態?

偽靜態(URL Rewrite)是指將動態 URL(如 index.php?action=page&id=18)重寫為靜態頁面形式的 URL(如 page-18.html),實際仍由 PHP 腳本處理。優點:URL 友好、利於 SEO、隱藏技術細節、便於遷移。

步驟 1:啟用 Apache mod_rewrite 模塊

  1. 查看 phpinfo() → Loaded Modules 中是否有 mod_rewrite。若有則已啟用。
  2. 若無,編輯 httpd.conf,找到 #LoadModule rewrite_module modules/mod_rewrite.so,刪除前面的 #。
  3. 若找不到該行,在 LoadModule 區域末尾添加:LoadModule rewrite_module modules/mod_rewrite.so。
  4. 重啟 Apache 服務。

步驟 2:允許 .htaccess 覆蓋配置

編輯 httpd.conf,找到網站根目錄對應的 <Directory> 塊:

<Directory "/your/web/root">
    Options FollowSymLinks
    AllowOverride All   # 將 None 改為 All
</Directory>

重啟 Apache 生效。

步驟 3:創建 .htaccess 文件

Windows 下無法直接創建以點開頭的文件,方法:

  1. 新建文本文件 htaccess.txt。
  2. 編寫規則後,命令行執行 ren htaccess.txt .htaccess,或使用支持的編輯器(VS Code、Notepad++、Sublime)直接保存為 .htaccess。

步驟 4:編寫 Rewrite 規則

基本語法

RewriteEngine On
RewriteRule 正則模式 目標URL [標誌]
  • RewriteEngine On:開啟重寫引擎。
  • RewriteRule:匹配模式支持 PCRE 正則,目標 URL 中 $1、$2 對應捕獲組。
  • 常用標誌:[L] (Last, 停止後續規則)、[NC] (No Case, 忽略大小寫)、[QSA] (Query String Append, 保留原查詢字符串)。

示例規則

# 將 page-18.html 映射到 index.php?action=page&id=18
RewriteEngine On
RewriteRule ^([a-zA-Z]+)-([0-9]+)\.html$ index.php?action=$1&id=$2 [L,QSA]

訪問 https://localhost/page-18.html 實際執行 index.php?action=page&id=18。

PHP 處理腳本 (index.php)

<?php
echo '你的 Action 是:' . htmlspecialchars($_GET['action'] ?? '');
echo '<br>';
echo '你的 ID 是:' . htmlspecialchars($_GET['id'] ?? '');
?>

進階:多規則與條件判斷

RewriteEngine On

# 靜態資源直接訪問,不重寫
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# 文章詳情: article-123.html -> article.php?id=123
RewriteRule ^article-([0-9]+)\.html$ article.php?id=$1 [L,QSA]

# 分類列表: category-5.html -> category.php?cid=5
RewriteRule ^category-([0-9]+)\.html$ category.php?cid=$1 [L,QSA]

# 捕獲所有其他請求到入口文件 (MVC 框架常用)
RewriteRule ^(.*)$ index.php?route=$1 [L,QSA]

常見問題排查

  • 500 Internal Server Error:語法錯誤、模塊未載入、AllowOverride 未設置。查看 Apache 錯誤日志。
  • 規則不生效:檢查 .htaccess 文件權限、路徑是否正確、是否在正確目錄下。
  • 循環重定向:規則匹配自身產生的 URL,添加 [L] 或使用 RewriteCond 排除。
  • 參數丟失:添加 [QSA] 標誌保留原查詢字符串。

Nginx 環境下的偽靜態

Nginx 不支持 .htaccess,需在虛擬主機配置中直接編寫 rewrite 指令:

location / {
    rewrite ^/([a-zA-Z]+)-([0-9]+)\.html$ /index.php?action=$1&id=$2 last;
    # 前端控制器模式
    try_files $uri $uri/ /index.php?$query_string;
}

結語

掌握 mod_rewrite 正則規則編寫是 PHP 開發者必備技能。建議在開發環境充分測試,上線前進行壓力測試,確保重寫性能對吞吐量影響可控。

copyright © 萬盛學電腦網 all rights reserved