Das Entwurfsmuster Page Controller ist ein gängiger Architekturansatz, der in webbasierten Systemen verwendet wird. Es organisiert den Kontrollfluss, indem es einem bestimmten Controller die Logik für eine einzelne Seite oder Anfrage zuweist. Dieser Ansatz trägt dazu bei, Verantwortlichkeiten zu isolieren und die Codebasis einfacher zu warten und weiterzuentwickeln.

Was ist der Seitencontroller?

Im Muster Page Controller hat jede Seite (oder eine Gruppe von Seiten mit ähnlichem Verhalten) ihren eigenen Controller, der verantwortlich ist für:

1. Bearbeitung der Anfrage: Vom Kunden gesendete Daten verarbeiten.
2. Ausführen der seitenspezifischen Logik: Eingaben validieren, mit Modellen interagieren oder Berechnungen durchführen.
3. Rendern einer Antwort: Übergeben verarbeiteter Daten an eine Ansicht (Vorlage) und Zurückgeben der endgültigen Antwort an den Client.

Vorteile des Musters

1. Einfacher Ablauf: Jede Seite ist einem eigenen dedizierten Controller zugeordnet.
2. Trennung von Belangen: Jeder Controller verarbeitet nur seine eigene Logik.
3. Wartbarkeit: Änderungen an einer Seite wirken sich nur auf den zugehörigen Controller aus.
4. Skalierbarkeit: Das Hinzufügen neuer Seiten ist unkompliziert und beeinträchtigt nicht die bestehende Funktionalität.

Grundstruktur

Eine typische Implementierung umfasst die folgenden Komponenten:

• Controller: PHP-Dateien, die Logik für bestimmte Seiten enthalten.
• Routen: Ein Routing-Mechanismus zum Zuordnen von URLs zu Controllern.
• Ansichten: Vorlagen, die zum Rendern der Benutzeroberfläche verwendet werden.

Fließen

1. Der Client sendet eine Anfrage an eine bestimmte URL.
2. Das Routing-System identifiziert den entsprechenden Controller für die Anfrage.
3. Der Controller führt die erforderliche Logik aus und delegiert das Rendern der Antwort an eine Ansicht.
4. Die Ansicht generiert die endgültige Ausgabe und gibt sie an den Client zurück.

Implementierungsbeispiel

Dateistruktur

/htdocs
    /src
        /Controllers
            HomeController.php
            AboutController.php
        /Services
            ViewRenderer.php
        /Views
            home.html.php
            about.html.php
    /public
        index.php
    /routes.php
    composer.json

Autoloader

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

composer dump-autoload

Vorlage

Vorlage für die Homepage und about.html.php.

    


    
= htmlspecialchars($title) ?>
    
= htmlspecialchars($content) ?>

ViewRenderer

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

HomeController

Verwaltet die Homepage-Logik.

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

AboutController

Verwaltet die Seitenlogik „Über uns“.

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

Definiert Routenzuordnungen zu Controllern.

use App\Controllers\HomeController;
use App\Controllers\AboutController;

// Define the routes in an associative array
return [
    '/' => HomeController::class,
    '/about' => AboutController::class,
];

index.php

Der Einstiegspunkt der Anwendung.

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

Für und Wider

Vorteile

• Organisation: Controller sind modular aufgebaut und verwalten jeweils eine bestimmte Seite.
• Wiederverwendbarkeit: Ansichten können über verschiedene Controller hinweg wiederverwendet werden.
• Debugging: Fehler lassen sich leichter nachverfolgen, da jede Seite über einen eigenen Controller verfügt.

Nachteile

• Erhöhte Anzahl von Controllern: Große Projekte können zu einer Vielzahl von Controllern führen, was eine bessere Organisation erfordert.
• Codeduplizierung: Die gemeinsame Logik aller Controller kann wiederholt werden. Dies kann durch die Verwendung einer Basis-Controller-Klasse gemildert werden.

Wann sollte das Page-Controller-Muster verwendet werden?

• Einfache Systeme: Am besten für kleine bis mittelgroße Webanwendungen geeignet, bei denen jede Seite eine spezifische Logik hat.
• Modulare Projekte: Wenn Sie die Logik für eine einfachere Wartung isolieren möchten.
• Ohne Frameworks: Ideal für PHP-Projekte ohne robuste Frameworks (wie Laravel oder Symfony).

Für komplexere Projekte, bei denen es eine erhebliche Wiederverwendung der Logik oder mehrere Einstiegspunkte gibt, sind Muster wie Front Controller oder die vollständige MVC-Architektur möglicherweise besser geeignet.