フロント コントローラーは、Web アプリケーション開発でリクエスト処理を一元化するために使用される設(shè)計(jì)パターンです。システムのさまざまな部分に複數(shù)のエントリ ポイントを持つ代わりに、すべてのリクエストは単一の中央コントローラーを介してルーティングされ、適切なコンポーネントまたはモジュールにリクエストを送信します。

仕組み

1. 単一のエントリ ポイント: すべての HTTP リクエストは、Web サーバー設(shè)定 (Apache の .htaccess や Nginx のルーティング ルールなど) を使用して単一のファイル (通常はindex.php) にリダイレクトされます。
2. ルーティング: フロント コントローラーは URL を分析し、コードのどの部分を?qū)g行するかを決定します。これは手動(dòng)で、またはルーティング ライブラリ/フレームワークを使用して実裝できます。
3. 委任: ルートに基づいて、フロント コントローラーはリクエストを適切なコントローラー (クラスまたはメソッド) に委任し、コントローラーはデータを処理して応答を返します。
4. レスポンス: コントローラーは、ブラウザーまたはクライアントに送り返されるレスポンス (通常は HTML または JSON) を生成します。

利點(diǎn)

• 一元化: すべての受信アプリケーション フローは 1 つのポイントを通じて処理されるため、リクエストの管理と追跡が容易になります。
• 柔軟性: 認(rèn)証、権限制御、ロギング、エラー処理などのグローバル機(jī)能を簡(jiǎn)単に統(tǒng)合します。
• 再利用性: 共通ロジックをフロント コントローラーに集中させて重複を減らすことができます。
• 保守性: 一元化により、新しいルートやコントローラーの追加などの更新が簡(jiǎn)素化されます。

例

ディレクトリ構(gòu)造

/app
    /Controllers
        HomeController.php
        ProductController.php
    /Core
        Entrypoint.php
/config
    routes.php
/public
    index.php
/vendor
composer.json

オートロード

PSR-4 を?qū)g裝するには、プロジェクト ルートにcomposer.json ファイルを作成します。

{
    "autoload": {
        "psr-4": {
            "App\": "app/"
        }
    }
}

次のコマンドを?qū)g行してオートローダーを生成します:

composer dump-autoload

リダイレクトリクエスト

apache(.htaccess)

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^ index.php [L]

nginx

server {
    listen 80;
    server_name example.com;

    root /path/to/your/project/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock; # Adjust for your PHP version
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~* \.(css|js|jpg|jpeg|png|gif|ico|woff|woff2|ttf|svg|eot|ttc|otf|webp|avif)$ {
        expires max;
        log_not_found off;
    }

    location ~ /\.ht {
        deny all;
    }
}

構(gòu)成ファイルを保存した後、Nginx を再起動(dòng)して変更を適用します

sudo systemctl reload nginx

コントローラー

ホームコントローラー

namespace App\Controllers;

class HomeController {
    public function index(): void {
        echo "Welcome to the home page!";
    }
}

プロダクトコントローラー

namespace App\Controllers;

class ProductController
{
    public function list(): void
    {
        echo "Product list.";
    }
}

コア

エントリーポイント

namespace App\Core;

class Entrypoint {

    public function __construct(private array $routes) {
    }

    public function handleRequest(): void {
        $uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

        if (isset($this->routes[$uri])) {
            $route = $this->routes[$uri];
            $controller = new $route['controller'];
            $method = $route['method'];

            if (method_exists($controller, $method)) {
                $controller->$method();
            } else {
                $this->sendResponse(500, "Method not found.");
            }
        } else {
            $this->sendResponse(404, "Page not found.");
        }
    }

    private function sendResponse(int $statusCode, string $message): void {
        http_response_code($statusCode);
        echo $message;
    }
}

構(gòu)成

ルート

$routes = [
    '/' => [
        'controller' => 'HomeController',
        'method' => 'index'
    ],
    '/products' => [
        'controller' => 'ProductController',
        'method' => 'list'
    ]
];

インデックス（フロントコントローラー）

require_once __DIR__ . '/../vendor/autoload.php';

use App\Core\Entrypoint;

$routes = require __DIR__ . '/../config/routes.php';

$entrypoint = new Entrypoint($routes);
$entrypoint->handleRequest();

結(jié)果

この実裝:

• フロント コントローラー パターンを使用してリクエスト処理を一元化します。
• Entrypoint クラス內(nèi)のルーティング ロジックをカプセル化します。
• 自動(dòng)ロードとコード構(gòu)成の改善のために PSR-4 を採(cǎi)用します。
• シームレスなセットアップのために Nginx 構(gòu)成を使用します。

以上がPHP デザイン パターン: フロント コントローラーの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語 Web サイトの他の関連記事を參照してください。