Организация маршрутов для товаров: эффективные методы PHP

Маршрут с категорией и подкатегорией

Допустим, нужен URL вида /catalog/electronics/phones/123. Реализация с помощью вложенных параметров.

<?php
$router->add('/catalog/{category:[a-z-]+}/{subcategory:[a-z-]+}/{id:\d+}', function($params) {
    echo "Категория: {$params['category']}, подкатегория: {$params['subcategory']}, ID товара: {$params['id']}";
});
?>
  

Результат для /catalog/electronics/phones/42:

Категория: electronics, подкатегория: phones, ID товара: 42

Проблема:

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

Middleware для проверки существования товара

Перед выполнением контроллера полезно убедиться, что товар существует в базе. Реализуем цепочку middleware в роутере.

<?php
class ProductMiddleware {
    public function handle(array $params, callable $next): void {
        $id = (int)($params['id'] ?? 0);
        // Проверка в БД
        $product = findProductById($id);
        if (!$product) {
            http_response_code(404);
            echo 'Товар не найден';
            return;
        }
        $params['product'] = $product;
        $next($params);
    }
}

// Использование:
$router->add('/product/{id}', function($params) {
    echo "Название товара: {$params['product']['name']}";
}, [new ProductMiddleware()]);
?>
  

Результат при отсутствии товара в базе:

404 Товар не найден

Типичная ошибка:

Middlewares вызываются неправильно - если не передавать управление дальше через $next, контроллер не выполнится. Решение: всегда вызывать $next внутри middleware после проверки.

Кеширование скомпилированных маршрутов

Для ускорения загрузки при большом количестве маршрутов стоит кешировать массив скомпилированных регулярных выражений.

<?php
class CachedRouter extends Router {
    private string $cacheFile;

    public function __construct(string $cacheFile = 'routes_cache.php') {
        $this->cacheFile = $cacheFile;
        if (file_exists($this->cacheFile)) {
            $this->routes = require $this->cacheFile;
        }
    }

    public function saveCache(): void {
        $export = var_export($this->routes, true);
        file_put_contents($this->cacheFile, "<?php return $export;");
    }

    // переопределяем dispatch, чтобы использовать кешированные регулярки
    public function dispatch(string $url): void {
        $url = trim(parse_url($url, PHP_URL_PATH), '/');
        foreach ($this->routes as $route) {
            $regex = $route['compiled'] ?? null;
            if ($regex && preg_match($regex, $url, $matches)) {
                $params = array_filter($matches, 'is_string', ARRAY_FILTER_USE_KEY);
                call_user_func($route['handler'], $params);
                return;
            }
        }
        http_response_code(404);
        echo 'Товар не найден';
    }
}

// Использование:
$router = new CachedRouter();
// после добавления всех маршрутов:
$router->saveCache();
?>
  

Результат: при первом запуске компилирует регулярки и сохраняет их. Последующие вызовы загружают кеш - производительность возрастает.

Проблемы:

Кеш не инвалидируется автоматически при добавлении новых маршрутов. Решение: очищать файл кеша при каждом развёртывании или использовать версионирование.

Генерация URL по имени маршрута (reverse routing)

Чтобы не хардкодить ссылки /product/42 в шаблонах, можно присваивать маршрутам имена и генерировать URL по ним.

<?php
class NamedRouter extends Router {
    private array $namedRoutes = [];

    public function addNamed(string $name, string $pattern, callable $handler): void {
        $this->add($pattern, $handler);
        $this->namedRoutes[$name] = $pattern;
    }

    public function generate(string $name, array $params = []): string {
        if (!isset($this->namedRoutes[$name])) {
            throw new \RuntimeException("Маршрут '$name' не найден");
        }
        $pattern = $this->namedRoutes[$name];
        // заменяем заполнители на значения параметров
        $url = preg_replace_callback('/\{([a-zA-Z_]+)(?::[^}]+)?\}/', function($m) use ($params) {
            return $params[$m[1]] ?? $m[0];
        }, $pattern);
        return '/' . ltrim($url, '/');
    }
}

// Использование:
$router->addNamed('product.view', '/product/{id:\d+}', 'handler');
echo $router->generate('product.view', ['id' => 123]);
?>
  

Результат:

/product/123

Типичная ошибка:

Если параметр не обязательный (например, {page?}), генерация может пропустить его. Решение: заранее проверять, есть ли параметр в шаблоне.