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

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

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

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

パターンの利点

1. シンプルなフロー: 各ページは独自の専用コントローラーにマップされます。
2. 懸念事項の分離: 各コントローラーは独自のロジックのみを処理します。
3. 保守性: 1 つのページへの変更は、そのページに関連付けられているコントローラにのみ影響します。
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) ?>

ビューレンダラー

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

アプリケーションのエントリ ポイント。

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 アーキテクチャのようなパターンがより適している可能性があります。