PHP デザインパターン: ページコントローラー-PHPチュートリアル-php.cn

PHP デザインパターン: ページコントローラー

DDD

リリース： 2024-12-28 07:42:30

オリジナル

283 人が閲覧しました

PHP Design Patterns: Page Controller

ページコントローラー デザインパターンは、Web ベースのシステムで使用される一般的なアーキテクチャアプローチです。特定のコントローラーを個別のページまたはリクエストのロジックの処理専用にすることで、制御フローを整理します。このアプローチは責任を分離するのに役立ち、コードベースの維持と進化が容易になります。

ページコントローラーとは何ですか?

ページコントローラー パターンでは、各ページ (または同様の動作を持つページのグループ) には、以下を担当する独自のコントローラーがあります。

リクエストの処理: クライアントから送信されたデータを処理します。
ページ固有のロジックの実行: 入力の検証、モデルとの対話、または計算の実行。
レスポンスのレンダリング: 処理されたデータをビュー (テンプレート) に渡し、最終レスポンスをクライアントに返します。

パターンの利点

簡単なフロー: 各ページは独自の専用コントローラーにマッピングされます。
懸念事項の分離: 各コントローラーは独自のロジックのみを処理します。
保守性: 1 つのページへの変更は、そのページに関連付けられているコントローラーにのみ影響します。
スケーラビリティ: 新しいページの追加は簡単で、既存の機能を中断しません。

基本構造

一般的な実装には次のコンポーネントが含まれます:

コントローラ: 特定のページのロジックを含む 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>

ログイン後にコピー

ビューレンダラー

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";
    }
}

ログイン後にコピー

ホームコントローラー

ホームページのロジックを処理します。

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

ログイン後にコピー