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

ページ コントローラー デザイン パターンは、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のテンプレート。

    <title>= htmlspecialchars($title) ?></title>


    <h1 id="htmlspecialchars-title-gt">= htmlspecialchars($title) ?></h1>
    <p>= htmlspecialchars($content) ?></p>

ビューレンダラー

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

長所と短所

メリット

• 組織: コントローラーはモジュール式であり、それぞれが特定のページを処理します。
• 再利用性: ビューはさまざまなコントローラー間で再利用できます。
• デバッグ: 各ページには独自の専用コントローラーがあるため、エラーの追跡が容易になります。

デメリット

• コントローラー数の増加: 大規模なプロジェクトではコントローラーが急増する可能性があり、より適切な組織化が必要になります。
• コードの重複: コントローラー間で共通のロジックが繰り返される場合があります。これは、基本コントローラー クラスを使用することで軽減できます。

ページ コントローラー パターンをいつ使用するか?

• シンプルなシステム: 各ページに特定のロジックがある小規模から中規模の Web アプリケーションに最適です。
• モジュール型プロジェクト: メンテナンスを容易にするためにロジックを分離したい場合。
• フレームワークなし: 堅牢なフレームワーク (Laravel や Symfony など) のない PHP プロジェクトに最適です。

大幅なロジックの再利用や複数のエントリ ポイントがある、より複雑なプロジェクトの場合は、フロント コントローラー または完全な MVC アーキテクチャ のようなパターンがより適している可能性があります。

以上がPHP デザイン パターン: ページ コントローラーの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。