页面控制器设计模式是基于 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架构之类的模式可能更合适。