PHP 單一入口模式深度解析：Dispatcher 核心機制、優勢劣勢與框架實踐

什麼是單一入口模式？

所有 HTTP 請求統一導向單一 PHP 檔案（通常是 index.php），由該檔案根據路由參數分派至對應處理邏輯。

傳統多入口 vs 單一入口

核心機制：Dispatcher 分派器

index.php 實質上是「第二層路由解析」：Web Server 解析檔案路徑 → PHP 解析業務路由。

最簡分派器實作

生產級分派器架構
run();

核心邏輯封裝在 Application 類別：

路由解析（支援 RESTful、參數綁定）
中介軟體管線（認證、日誌、CORS、限流）
控制器實例化與動作執行
視圖渲染與回應輸出
異常捕獲與錯誤處理


單一入口的五大核心優勢


集中式安全防護：單一點實施輸入過濾、XSS/CSRF 防護、權限驗證、SQL 注入防禦
統一請求預處理：編碼統一、參數規範化、共用資料載入（配置、語系、使用者狀態）
易於實作橫切關注點：日誌記錄、效能監控、快取控制、API 版本管理
支援優雅的 URL 重寫：配合 Apache mod_rewrite 或 Nginx try_files 實現 /news/123 美觀網址
框架整合基礎：所有現代 PHP 框架（Laravel、Symfony、ThinkPHP、CodeIgniter）皆採單一入口


常見誤區與劣勢

誤區：入口檔案會變成「麵條代碼」
事實：入口檔案應極簡（< 20 行），核心邏輯委派給框架核心類別。複雜度在架構設計，不在入口檔案。

劣勢：URL 不夠美觀、SEO 不友善
// 原始：index.php?module=news&action=detail&id=123
// 解決方案：
// 1. URL 重寫
// Apache .htaccess:
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php/$1 [L,QSA]

// 2. PATH_INFO 模式
// index.php/news/detail/123
// $_SERVER['PATH_INFO'] = '/news/detail/123'

劣勢：單點故障風險
入口檔案掛掉 = 全站掛掉。緩解：極簡入口、完善錯誤處理、健康檢查端點、多層快取。

功能模組組織策略

方案一：模組目錄 + 獨立檔案
app/
├── modules/
│   ├── news/
│   │   ├── list.php
│   │   ├── detail.php
│   │   └── edit.php
│   └── user/
│       ├── login.php
│       └── register.php
優點：團隊協作無衝突。缺點：共用邏輯需額外 include。

方案二：單檔案多函式/類別（推薦）
// app/modules/News.php
class NewsModule {
    public function list() { ... }
    public function detail($id) { ... }
    public function edit($id) { ... }
    private function getCategories() { ... } // 共用邏輯
}
優點：共用邏輯自然封裝、自動載入友善。缺點：需版本控制解決衝突。

主流框架的單一入口實踐

框架
入口檔案
核心分派類別
路由定義
Laravel
public/index.php
Kernel / Router
routes/web.php
Symfony
public/index.php
Kernel / HttpKernel
config/routes.yaml
ThinkPHP
public/index.php
App / Dispatch
route/route.php
CodeIgniter 4
public/index.php
CodeIgniter / Router
app/Config/Routes.php


混合模式建議
高流量公開頁（新聞列表、文章詳情）使用靜態化/獨立入口利於 SEO；互動功能（登入、發文、API）使用單一入口利於安全與維護。

單一入口模式不是銀彈，但它是現代 PHP 應用架構的基石。理解其核心——Dispatcher 的職責邊界、路由解析策略、中介軟體管線設計——才能駕馭各大框架，甚至自建輕量架構。