PHP 設計模式：頁面控制器-php教程-PHP中文網

PHP 設計模式：頁面控制器

DDD

發布： 2024-12-28 07:42:30

原創

283 人瀏覽過

PHP Design Patterns: Page Controller

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

什麼是頁面控制器？

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

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

該模式的優點

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

基本結構

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

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

流動

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

實施例

檔案結構

/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.
的模板

<!DOCTYPE html>
<html>
<head>
    <title><?= htmlspecialchars($title) ?></title>
</head>
<body>
    <h1><?= htmlspecialchars($title) ?></h1>
    <p><?= htmlspecialchars($content) ?></p>
</body>
</html>

登入後複製

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

應用程式的入口點。

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

登入後複製