頁面控制器設計模式是基於 Web 的系統中所使用的常見架構方法。它透過專用特定控制器來處理單一頁面或請求的邏輯來組織控制流程。這種方法有助於隔離職責，使程式碼庫更易於維護和發展。

什麼是頁面控制器？

在頁面控制器模式中，每個頁面（或一組具有相似行為的頁面）都有自己的控制器，負責：

1. 處理請求：處理客戶端發送的資料。
2. 執行頁面特定邏輯：驗證輸入、與模型互動或執行計算。
3. 渲染回應：將處理後的資料傳遞到視圖（範本）並將最終回應傳回給客戶端。

該模式的優點

1. 簡單流程：每個頁面都對應到自己的專用控制器。
2. 著重點分離：每個控制器只處理自己的邏輯。
3. 可維護性：對一頁的變更僅影響其關聯的控制器。
4. 可擴充性：新增頁面非常簡單，不會破壞現有功能。

基本結構

典型的實作涉及以下元件：

• 控制器：包含特定頁面邏輯的PHP檔案。
• 路由：將 URL 對應到控制器的路由機制。
• 視圖：用於呈現使用者介面的範本。

流動

1. 客戶端向特定URL發送請求。
2. 路由系統為請求識別適當的控制器。
3. 控制器執行所需的邏輯並將回應渲染委託給視圖。
4. 視圖產生最終輸出並將其傳回給客戶端。

實施例

文件結構

/htdocs
    /src
        /Controllers
            HomeController.php
            AboutController.php
        /Services
            ViewRenderer.php
        /Views
            home.html.php
            about.html.php
    /public
        index.php
    /routes.php
    composer.json

自動裝載機

{
    "autoload": {
        "psr-4": {
            "App\\": "htdocs/"
        }
    }
}

composer dump-autoload

模板

首頁範本和about.html.php.

    


    
= htmlspecialchars($title) ?>
    
= htmlspecialchars($content) ?>

ViewRenderer

namespace App\Services;

class ViewRenderer {

    public function render(string $view, array $data = []): void {
        extract($data); // Turns array keys into variables
        include __DIR__ . "/../../Views/{$view}.html.php";
    }
}

HomeController

處理主頁邏輯。

namespace App\Controllers;

use App\Services\ViewRenderer;

class HomeController {

    public function __construct(private ViewRenderer $viewRenderer)
    {
    }

    public function handleRequest(): void {
        $data = [
            'title' => 'Welcome to the Site',
            'content' => 'Homepage content.',
        ];

        $this->viewRenderer->render('home', $data);
    }
}

關於控制器

處理「關於我們」頁面邏輯。

namespace App\Controllers;

use App\Services\ViewRenderer;

class AboutController
{

    public function __construct(private ViewRenderer $viewRenderer)
    {
    }

    public function handleRequest(): void {
        $data = [
            'title' => 'About Us',
            'content' => 'Information about the company.',
        ];

        $this->viewRenderer->render('about', $data);
    }
}

routes.php

定義到控制器的路由對映。

use App\Controllers\HomeController;
use App\Controllers\AboutController;

// Define the routes in an associative array
return [
    '/' => HomeController::class,
    '/about' => AboutController::class,
];

index.php

應用程式的入口點。

require_once __DIR__ . '/../vendor/autoload.php';

use App\Services\ViewRenderer;

// Include the routes
$routes = require_once __DIR__ . '/../routes.php';

// Instantiate the view rendering service
$viewRenderer = new ViewRenderer();

// Get the current route from the request URI
$requestUri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

// Check if the route exists and resolve the controller
if (isset($routes[$requestUri])) {
    $controllerClass = $routes[$requestUri];
    $controller = new $controllerClass($viewRenderer);
    $controller->handleRequest();
} else {
    http_response_code(404);
    echo "Page not found.";
}

優點和缺點

優點

• 組織：控制器是模組化的，每個控制器處理一個特定的頁面。
• 可重複使用性：視圖可以在不同的控制器之間重複使用。
• 調試：由於每個頁面都有自己的專用控制器，因此更容易追蹤錯誤。

缺點

• 控制器數量增加：大型專案可能導致控制器激增，需要更好的組織。
• 程式碼重複：控制器之間的通用邏輯可能會重複。這可以透過使用基本控制器類別來緩解。

何時使用頁面控制器模式？

• 簡單系統：最適合每個頁面都有特定邏輯的中小型 Web 應用程式。
• 模組化專案：當您想要隔離邏輯以便於維護。
• 沒有框架：非常適合沒有強大框架（如 Laravel 或 Symfony）的 PHP 專案。

對於更複雜的項目，存在大量邏輯重用或多個入口點，前端控制器或完整MVC架構之類的模式可能更合適。