ホームページ >バックエンド開発 >PHPチュートリアル >PHP デザインパターン: ページコントローラー

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

DDDオリジナル: 2024-12-28 07:42:30289ブラウズ

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

長所と短所

メリット

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

デメリット

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

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

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

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

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

php symfony laravel mvc html for Validating using class Interface map number this input

声明：

この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。

前の記事：PHP でフォーム入力配列に適切にアクセスして処理する方法は?次の記事：PHP でフォーム入力配列に適切にアクセスして処理する方法は?

続きを見る

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