Настройка файла index.php для модульного PHP приложения

Расширенные примеры работы модуля index.php

Рассмотрим нестандартный вариант: использование самописного роутера с поддержкой middleware и групповыми маршрутами. Этот пример демонстрирует, как можно реализовать модульный index.php без сторонних библиотек, но с высокой гибкостью.

<?php
// index.php
spl_autoload_register(function ($class) {
    $prefix = 'App\\';
    $baseDir = __DIR__ . '/src/';
    $len = strlen($prefix);
    if (strncmp($prefix, $class, $len) !== 0) {
        return;
    }
    $relativeClass = substr($class, $len);
    $file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
    if (file_exists($file)) {
        require $file;
    }
});

class Router {
    private array $routes = [];
    private array $middleware = [];

    public function add(string $method, string $pattern, callable $handler, array $middleware = []): void {
        $this->routes[] = ['method' => $method, 'pattern' => $pattern, 'handler' => $handler];
        $this->middleware = array_merge($this->middleware, $middleware);
    }

    public function dispatch(string $method, string $uri): void {
        foreach ($this->routes as $route) {
            if ($route['method'] !== $method) continue;
            $regex = preg_replace('/\{([a-zA-Z_]+)\}/', '(?P<$1>[^/]+)', $route['pattern']);
            $regex = '#^' . $regex . '$#';
            if (preg_match($regex, $uri, $matches)) {
                $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY);
                // Выполнение middleware
                foreach ($this->middleware as $mw) {
                    $mw();
                }
                call_user_func_array($route['handler'], $params);
                return;
            }
        }
        http_response_code(404);
        echo "Page not found";
    }
}

$router = new Router();

// Middleware для проверки аутентификации
$authMiddleware = function () {
    if (!isset($_COOKIE['token'])) {
        http_response_code(401);
        echo "Unauthorized";
        exit;
    }
};

// Группа маршрутов для админ-панели
$router->add('GET', '/admin', function () {
    echo "Admin panel";
}, [$authMiddleware]);

$router->add('GET', '/admin/users/{id}', function ($id) {
    echo "User id: " . $id;
}, [$authMiddleware]);

// Публичный маршрут
$router->add('GET', '/', function () {
    echo "Home page";
});

$uri = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
$router->dispatch($_SERVER['REQUEST_METHOD'], $uri);

(Результат при обращении к /admin без cookie: HTTP 401, сообщение "Unauthorized". При наличии cookie: выводится "Admin panel".)

Дополнительно рассмотрим пример с загрузкой модулей через конфигурационный файл и автоматическим подключением их маршрутов:

<?php
// config/modules.php
return [
    'Home' => [
        'active' => true,
        'routes' => [
            'GET /' => 'HomeController@index',
        ]
    ],
    'User' => [
        'active' => true,
        'routes' => [
            'GET /user/{id}' => 'UserController@show',
            'POST /user' => 'UserController@create',
        ]
    ],
    'Unused' => [
        'active' => false,
        'routes' => []
    ]
];

// index.php
$modules = include 'config/modules.php';
foreach ($modules as $moduleName => $config) {
    if (!$config['active']) continue;
    $classPrefix = "App\\Modules\\$moduleName\\Controllers\\";
    foreach ($config['routes'] as $routeDef => $action) {
        list($method, $uri) = explode(' ', $routeDef, 2);
        $router->add($method, $uri, function () use ($action, $classPrefix) {
            list($controllerName, $methodName) = explode('@', $action);
            $fullClass = $classPrefix . $controllerName;
            $controller = new $fullClass();
            echo $controller->$methodName(...func_get_args());
        });
    }
}

В этом примере модули регистрируются автоматически, что упрощает добавление новых компонентов без изменения основного файла.