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

登录后复制