The Page Controller design pattern is a common architectural approach used in web-based systems. It organizes the flow of control by dedicating a specific controller to handle the logic for an individual page or request. This approach helps isolate responsibilities, making the codebase easier to maintain and evolve.
In the Page Controller pattern, each page (or a group of pages with similar behavior) has its own controller, responsible for:
A typical implementation involves the following components:
Flow
File Structure
/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
Template
Template for the homepage and about.html.php.
<!DOCTYPE html> <html> <head> <title><?= htmlspecialchars($title) ?></title> </head> <body> <h1><?= htmlspecialchars($title) ?></h1> <p><?= htmlspecialchars($content) ?></p> </body> </html>
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
Handles the homepage logic.
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
Handles the "About Us" page logic.
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
Defines route mappings to controllers.
use App\Controllers\HomeController; use App\Controllers\AboutController; // Define the routes in an associative array return [ '/' => HomeController::class, '/about' => AboutController::class, ];
index.php
The application’s entry point.
/htdocs /src /Controllers HomeController.php AboutController.php /Services ViewRenderer.php /Views home.html.php about.html.php /public index.php /routes.php composer.json
Advantages
Disadvantages
For more complex projects, where there is significant logic reuse or multiple entry points, patterns like Front Controller or full MVC architecture may be more suitable.
The above is the detailed content of PHP Design Patterns: Page Controller. For more information, please follow other related articles on the PHP Chinese website!