前端控制器是Web應(yīng)用程序開(kāi)發(fā)中用于集中請(qǐng)求處理的設(shè)計(jì)模式。所有請(qǐng)求都通過(guò)單個(gè)中央控制器路由，負(fù)責(zé)將它們定向到適當(dāng)?shù)慕M件或模塊，而不是為系統(tǒng)的不同部分設(shè)置多個(gè)入口點(diǎn)。

它是如何運(yùn)作的

1. 單一入口點(diǎn)： 所有 HTTP 請(qǐng)求都使用 Web 服務(wù)器配置（例如，Apache 的 .htaccess 或 Nginx 中的路由規(guī)則）重定向到單個(gè)文件（通常為 index.php）。
2. 路由：前端控制器分析 URL 并確定應(yīng)該執(zhí)行哪一部分代碼。這可以手動(dòng)實(shí)現(xiàn)或使用路由庫(kù)/框架來(lái)實(shí)現(xiàn)。
3. 委托：根據(jù)路由，前端控制器將請(qǐng)求委托給適當(dāng)?shù)目刂破鳎惢蚍椒ǎ?，該控制器處理?shù)據(jù)并返回響應(yīng)。
4. 響應(yīng)： 控制器生成一個(gè)響應(yīng)（通常是 HTML 或 JSON），發(fā)送回瀏覽器或客戶端。

優(yōu)點(diǎn)

• 集中化：所有傳入的應(yīng)用程序流都通過(guò)單點(diǎn)處理，從而更輕松地管理和跟蹤請(qǐng)求。
• 靈活性：輕松集成全局功能，如身份驗(yàn)證、權(quán)限控制、日志記錄或錯(cuò)誤處理。
• 復(fù)用性：通用邏輯可以集中在前端控制器中，減少重復(fù)。
• 可維護(hù)性：集中化簡(jiǎn)化了更新，例如添加新的路由或控制器。

例子

目錄結(jié)構(gòu)

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

自動(dòng)加載

要實(shí)現(xiàn)PSR-4，請(qǐng)?jiān)陧?xiàng)目根目錄中創(chuàng)建一個(gè)composer.json文件：

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

運(yùn)行以下命令來(lái)生成自動(dòng)加載器：

composer dump-autoload

重定向請(qǐng)求

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

保存配置文件后，重新啟動(dòng) Nginx 以應(yīng)用更改

sudo systemctl reload nginx

控制器

HomeController

namespace App\Controllers;

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

產(chǎn)品控制器

namespace App\Controllers;

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

核

入口點(diǎn)

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

配置

路線

$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é)果

此實(shí)現(xiàn)：

• 使用前端控制器模式集中請(qǐng)求處理。
• 將路由邏輯封裝在 Entrypoint 類中。
• 采用 PSR-4 進(jìn)行自動(dòng)加載和更好的代碼組織。
• 使用 Nginx 配置進(jìn)行無(wú)縫設(shè)置。

以上是PHP 設(shè)計(jì)模式：前端控制器的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！