Главная страница PHP: варианты реализации и выбор оптимальной структуры

Расширенные примеры реализации точки входа

Пример 1: Кастомный Front Controller с поддержкой middleware и 404

Полноценный класс Router, который обрабатывает URL, извлекает параметры и вызывает замыкания или методы контроллеров. Включён простой middleware для логирования.

<?php
// index.php
class Router {
    private $routes = [];
    private $middleware = [];

    public function add($pattern, $handler) {
        $this->routes[$pattern] = $handler;
    }

    public function addMiddleware($mw) {
        $this->middleware[] = $mw;
    }

    public function dispatch($uri) {
        $uri = parse_url($uri, PHP_URL_PATH);
        $matched = false;
        foreach ($this->routes as $pattern => $handler) {
            $regex = preg_replace('/\{[a-zA-Z_]+\}/', '([^/]+)', $pattern);
            $regex = '/^' . str_replace('/', '\/', $regex) . '$/';
            if (preg_match($regex, $uri, $matches)) {
                array_shift($matches);
                // Выполнить middleware
                foreach ($this->middleware as $mw) {
                    $mw($uri);
                }
                // Вызвать обработчик
                if (is_callable($handler)) {
                    call_user_func_array($handler, $matches);
                } elseif (is_string($handler)) {
                    list($class, $method) = explode('@', $handler);
                    $controller = new $class();
                    call_user_func_array([$controller, $method], $matches);
                }
                $matched = true;
                break;
            }
        }
        if (!$matched) {
            http_response_code(404);
            echo 'Страница не найдена';
        }
    }
}

// Middleware логирования
$logMiddleware = function($uri) {
    error_log("Запрос: $uri");
};

$router = new Router();
$router->addMiddleware($logMiddleware);
$router->add('/', function() {
    echo 'Главная страница';
});
$router->add('/user/{id}', function($id) {
    echo "Пользователь с ID: $id";
});
$router->dispatch($_SERVER['REQUEST_URI']);
?>

Результат при переходе на /user/42:
Пользователь с ID: 42
(в логах сервера появится запись "Запрос: /user/42")

Пример 2: Простой MVC на чистом PHP с единой точкой входа

Реализация Front Controller в стиле MVC: index.php загружает конфигурацию, определяет контроллер по маршруту и вызывает нужный метод. Контроллеры используют модели и возвращают представления.

<?php
// index.php
require 'config.php';
require 'core/Router.php';
require 'core/Controller.php';
require 'core/View.php';

$router = new Router();
$router->add('/', 'HomeController@index');
$router->add('/post/{id}', 'PostController@show');
$router->add('/contact', 'ContactController@index');

$router->dispatch($_SERVER['REQUEST_URI']);
?>

// Пример контроллера (src/controllers/HomeController.php)
class HomeController extends Controller {
    public function index() {
        $data = ['title' => 'Главная', 'content' => 'Добро пожаловать!'];
        $this->view('home', $data);
    }
}

// Пример представления (views/home.php)
<h2><?= $title ?></h2>
<p><?= $content ?></p>

При обращении к / будет выведено:
Главная
Добро пожаловать!

Пример 3: Использование библиотеки FastRoute (composer require nikic/fast-route)

Популярная библиотека для маршрутизации. В index.php определяется диспетчер, а роутер сам выбирает обработчик.

<?php
require 'vendor/autoload.php';

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

$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 'Method Not Allowed';
        break;
    case FastRoute\Dispatcher::FOUND:
        $handler = $routeInfo[1];
        $vars = $routeInfo[2];
        list($class, $method) = explode('@', $handler);
        $controller = new $class();
        call_user_func_array([$controller, $method], $vars);
        break;
}
?>

Для URL /post/123 будет вызван метод show() в PostController с аргументом 123.
Если маршрут не найден – отобразится "404 Not Found".