ThinkPHP 四種 URL 訪問模式全解析：從 PATHINFO 到 REWRITE 的 SEO 優化之路

ThinkPHP URL 路由模式完全指南：模式對比、配置技巧與 SEO 最佳實踐

ThinkPHP 提供 4 種 URL 訪問模式，滿足從開發調試到生產上線的不同需求。本文系統梳理各模式結構差異、配置方法、優缺點對比，助你選擇最適合項目的路由策略。

MVC 基礎回顧

• M (Model)：Lib/Model/ - 數據操作
• V (View)：Tpl/ - 頁面展示
• C (Controller)：Lib/Action/ - 業務邏輯控制

四大 URL 模式詳細對比

完整 URL 結構拆解

https://domain.com / project / index.php / Module / Action / key1 / val1 / key2 / val2
        │              │          │           │        │       │        │        │
      域名          項目目錄    入口文件    模塊名    方法名   參數鍵   參數值   參數鍵   參數值

配置文件核心設置 (Home/Conf/config.php)

<?php
return [
    // URL 模式選擇: 0=普通, 1=PATHINFO, 2=REWRITE, 3=兼容
    'URL_MODEL' => 1,
    
    // PATHINFO 分隔符修改：默認 '/', 可改為 '-'
    'URL_PATHINFO_DEPR' => '-',
    // 效果: /User-login-id-1 (需配合路由規則)
    
    // 大小寫敏感：true=不區分(推薦)
    'URL_CASE_INSENSITIVE' => true,
    
    // 偽靜態後綴限制
    'URL_HTML_SUFFIX' => 'html|shtml|xml',
    
    // 開啟路由
    'URL_ROUTER_ON' => true,
    
    // 路由規則定義
    'URL_ROUTE_RULES' => [
        'login/:id' => 'User/login',
        '/^article\/(\d+)$/' => 'Article/detail?id=:1',
    ],
];
?>

入口文件調試模式 (index.php)

<?php
// 開啟調試模式：禁用緩存、顯示詳細錯誤、開啟頁面 Trace
define('APP_DEBUG', true);
define('APP_PATH', './Home/');
require './ThinkPHP/ThinkPHP.php';

REWRITE 模式啟用全流程

Apache (.htaccess)

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>

需確保 httpd.conf 載入 mod_rewrite 並允許 AllowOverride All。

Nginx

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php/$1 last;
        break;
    }
}

調試利器：頁面 Trace

<?php
// config.php
'SHOW_PAGE_TRACE' => true,  // 頁面右下角顯示調試面板
// 包含: SQL日誌、執行流程、文件加載、變量值、錯誤信息等

模式選擇決策樹

項目上線嗎？
  ├─ 否 → 開發環境用 PATHINFO (URL_MODEL=1) + APP_DEBUG=true
  └─ 是 → Web服務器支援 Rewrite 嗎？
          ├─ 是 → REWRITE 模式 (URL_MODEL=2) + .htaccess/nginx配置
          └─ 否 → 支援 PATHINFO 嗎？
                  ├─ 是 → PATHINFO 模式 (URL_MODEL=1)
                  └─ 否 → 兼容模式 (URL_MODEL=3)

常見問題 FAQ

最佳實踐總結

1. 開發期：PATHINFO + 調試模式，便於 Trace 調試
2. 上線前：切換 REWRITE，配置 Web 服務器，關閉調試
3. 路由配置：僅為核心業務(首頁、列表、詳情)配置優雅路由，避免過度配置
4. 分隔符：保持默認 /，利於 RESTful 與前端框架路由兼容
5. 大小寫：強制開啟不區分大小寫，避免 Linux/Windows 環境差異導致 404

合理選擇並配置 URL 模式，不僅關乎 SEO 與用戶體驗，更是項目專業度的重要體現。