Контроллер в PHP: от простого index.php до профессионального роутера

Расширенные примеры реализации контроллера в PHP MVC

Пример 1: Полный фронт-контроллер с классом Router, автозагрузкой и обработкой ошибок

Структура проекта:

project/
├── composer.json
├── public/
│   └── index.php          # точка входа
├── src/
│   ├── Controllers/
│   │   ├── HomeController.php
│   │   ├── PostController.php
│   │   └── BaseController.php
│   ├── Router.php
│   └── Middleware/
│       ├── AuthMiddleware.php
│       └── CorsMiddleware.php
└── views/

composer.json:

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

После выполнения composer dump-autoload.

public/index.php:

<?php

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

use App\Routing\Router;
use App\Middleware\AuthMiddleware;
use App\Middleware\CorsMiddleware;
use App\Controllers\HomeController;
use App\Controllers\PostController;

// Создаём маршрутизатор
$router = new Router();

// Определяем маршруты
$router->add('GET', '/', [HomeController::class, 'index']);
$router->add('GET', '/about', [HomeController::class, 'about']);
$router->add('GET', '/post/{id:\d+}', [PostController::class, 'show']);
$router->add('POST', '/post/{id}/comment', [PostController::class, 'addComment']);

// Middleware цепочка
$middlewares = [
    CorsMiddleware::class,
    AuthMiddleware::class,
];

// Обработка запроса
$request = [
    'method' => $_SERVER['REQUEST_METHOD'],
    'uri'    => parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH),
];

// Пропускаем через middleware
$next = function($req) use ($router) {
    return $router->dispatch($req['method'], $req['uri']);
};

foreach ($middlewares as $middlewareClass) {
    $middleware = new $middlewareClass();
    $result = $middleware->handle($request, $next);
    if ($result !== null) {
        // Если middleware вернул ответ, завершаем
        echo $result;
        exit;
    }
    $next = function($req) use ($middleware, $next) {
        return $middleware->handle($req, $next);
    };
}

// Выполняем финальный обработчик
$response = $router->dispatch($request['method'], $request['uri']);
if ($response) {
    echo $response;
} else {
    http_response_code(404);
    echo 'Страница не найдена';
}

src/Routing/Router.php:

<?php
namespace App\Routing;

class Router
{
    private $routes = [];

    public function add(string $method, string $pattern, callable|array $handler): void
    {
        // Преобразуем шаблон вида /post/{id:\d+} в регулярное выражение
        $pattern = preg_replace('/\{[a-zA-Z_]+:([^}]+)\}/', '($1)', $pattern);
        $pattern = '#^' . $pattern . '$#';
        $this->routes[] = compact('method', 'pattern', 'handler');
    }

    public function dispatch(string $method, string $uri): mixed
    {
        foreach ($this->routes as $route) {
            if ($route['method'] === $method && preg_match($route['pattern'], $uri, $matches)) {
                array_shift($matches); // Убираем полное совпадение
                if (is_array($route['handler'])) {
                    list($class, $action) = $route['handler'];
                    $controller = new $class();
                    return call_user_func_array([$controller, $action], $matches);
                }
                return call_user_func_array($route['handler'], $matches);
            }
        }
        return null;
    }
}

Пример контроллера (src/Controllers/HomeController.php):

<?php
namespace App\Controllers;

class HomeController
{
    public function index(): string
    {
        return '<h1>Главная страница</h1>';
    }

    public function about(): string
    {
        return '<h1>О нас</h1>';
    }
}

Пример middleware (src/Middleware/AuthMiddleware.php):

<?php
namespace App\Middleware;

class AuthMiddleware
{
    public function handle(array $request, callable $next): mixed
    {
        session_start();
        if (!isset($_SESSION['user'])) {
            header('Location: /login');
            exit;
        }
        return $next($request);
    }
}

Результат: при обращении к / без авторизации произойдёт редирект на /login. Если авторизация пройдена, будет выведен HTML главной страницы.

Пример 2: Контроллер с внедрением зависимостей (DI) через конструктор

Часто контроллеру требуется работа с БД или шаблонизатором. Вместо создания экземпляров внутри класса используйте DI-контейнер. Ниже простой пример без сторонних библиотек.

<?php
// src/Controllers/PostController.php
namespace App\Controllers;

use App\Services\PostService;
use App\View\Renderer;

class PostController
{
    private $postService;
    private $renderer;

    public function __construct(PostService $postService, Renderer $renderer)
    {
        $this->postService = $postService;
        $this->renderer    = $renderer;
    }

    public function show(int $id): string
    {
        $post = $this->postService->findById($id);
        return $this->renderer->render('post', ['post' => $post]);
    }
}

// В Router при создании контроллера нужно передать зависимости.
// Для этого можно создать простой контейнер:
// $container = new Container();
// $container->set(PostService::class, function() { return new PostService(new PDO('...')); });
// $container->set(Renderer::class, function() { return new Renderer(__DIR__.'/../views'); });
// При создании контроллера: $container->resolve(PostController::class);

Результат: контроллер получает готовые сервисы, что упрощает тестирование (можно подменять зависимости на моки).

Пример 3: Использование FastRoute (популярная библиотека)

FastRoute от Никиты Попова - быстрый и гибкий маршрутизатор.

// Установка: composer require nikic/fast-route

// public/index.php
$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addRoute('GET', '/', 'HomeController@index');
    $r->addRoute('GET', '/post/{id:\d+}', 'PostController@show');
    $r->addRoute('POST', '/post/{id}/comment', 'PostController@addComment');
});

$httpMethod = $_SERVER['REQUEST_METHOD'];
$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

$routeInfo = $dispatcher->dispatch($httpMethod, $uri);
switch ($routeInfo[0]) {
    case FastRoute\Dispatcher::NOT_FOUND:
        http_response_code(404);
        echo '404 Not Found';
        break;
    case FastRoute\Dispatcher::METHOD_NOT_ALLOWED:
        http_response_code(405);
        echo '405 Method Not Allowed';
        break;
    case FastRoute\Dispatcher::FOUND:
        $handler = $routeInfo[1];
        $vars = $routeInfo[2];
        // Разбираем строку типа 'Controller@action'
        list($class, $method) = explode('@', $handler);
        $controller = new $class();
        echo call_user_func_array([$controller, $method], $vars);
        break;
}

Результат: FastRoute сам обрабатывает 404 и 405, поддерживает кэширование маршрутов, что ускоряет работу.

Пример 4: Обработка ошибок и логирование в контроллере

Полезно создать базовый контроллер с перехватом исключений.

<?php
namespace App\Controllers;

abstract class BaseController
{
    protected function render(string $view, array $data = []): string
    {
        $file = __DIR__ . '/../../views/' . $view . '.php';
        if (!file_exists($file)) {
            throw new \RuntimeException("View $view not found");
        }
        extract($data);
        ob_start();
        include $file;
        return ob_get_clean();
    }

    public function __call($name, $arguments)
    {
        // Логируем вызов несуществующего метода
        error_log("Неизвестный метод $name в " . get_class($this));
        http_response_code(500);
        return 'Внутренняя ошибка сервера';
    }
}

// Пример использования в PostController
class PostController extends BaseController
{
    public function show($id)
    {
        try {
            $post = $this->postService->findById($id);
            return $this->render('post', compact('post'));
        } catch (\Exception $e) {
            error_log($e->getMessage());
            http_response_code(404);
            return 'Пост не найден';
        }
    }
}

Результат: единый механизм обработки ошибок, логирование и пользовательские страницы ошибок.

Пример 5: Контроллер для API с выводом JSON

Устанавливаем заголовки и возвращаем сериализованные данные.

<?php
namespace App\Controllers;

class ApiController
{
    public function users()
    {
        header('Content-Type: application/json');
        $users = [
            ['id' => 1, 'name' => 'Анна'],
            ['id' => 2, 'name' => 'Борис'],
        ];
        echo json_encode($users);
    }

    public function createUser()
    {
        $input = json_decode(file_get_contents('php://input'), true);
        if (!$input || !isset($input['name'])) {
            http_response_code(400);
            echo json_encode(['error' => 'Не передано имя']);
            return;
        }
        // Сохраняем в БД...
        http_response_code(201);
        echo json_encode(['status' => 'created']);
    }
}

Результат: при обращении к /api/users (GET) вернётся JSON-массив. При POST на /api/users с телом {'name':'Вася'} вернётся ответ 201.