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

Примеры кода с пояснениями и результатами

Пример 1: Полная реализация самописного роутера с автозагрузкой.

// index.php
require 'autoload.php';

$router = new Router();
$router->addRoute('#^/category/(\d+)(/([a-z0-9-]+))?$#', function($matches) {
    $id = (int)$matches[1];
    $slug = $matches[3] ?? null;
    $category = Category::find($id);
    if (!$category) {
        http_response_code(404);
        echo '404 Not Found';
        return;
    }
    if ($slug && $slug !== $category->slug) {
        header('Location: /category/' . $id . '/' . $category->slug, true, 301);
        return;
    }
    echo 'Category: ' . $category->name;
});

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

При запросе /category/5/electronics выводится: Category: Electronics
При запросе /category/5/wrong-slug происходит редирект (301) на /category/5/electronics

Пример 2: Laravel: маршрут с middleware для проверки активной категории и breadcrumb.

// routes/web.php
Route::middleware('active.category')->get('/category/{category}/{slug?}', function (Category $category, $slug = null) {
    if ($slug && $slug !== $category->slug) {
        return redirect()->route('category.show', [$category, $category->slug], 301);
    }
    // Генерация breadcrumb
    $breadcrumbs = [];
    $cat = $category;
    while ($cat) {
        $breadcrumbs[] = ['url' => route('category.show', [$cat, $cat->slug]), 'name' => $cat->name];
        $cat = $cat->parent;
    }
    $breadcrumbs = array_reverse($breadcrumbs);
    return view('category.show', compact('category', 'breadcrumbs'));
})->name('category.show');

// app/Http/Middleware/CheckActiveCategory.php
public function handle($request, Closure $next)
{
    $category = $request->route('category');
    if (!$category->is_active) {
        abort(404);
    }
    return $next($request);
}

При переходе на /category/5/electronics страница отображается с хлебными крошками:
Главная - Электроника (если родительская категория существует)
Если категория не активна, выдается 404 ошибка.

Пример 3: Symfony Router: интеграция с DI-контейнером и генерация URL.

// routes.php
use Symfony\Component\Routing\Generator\UrlGenerator;
use Symfony\Component\Routing\Matcher\UrlMatcher;
use Symfony\Component\Routing\RequestContext;

$routes = new RouteCollection();
$route = new Route('/category/{id}/{slug}', ['_controller' => 'show'], ['id' => '\d+']);
$routes->add('category_show', $route);

$context = new RequestContext('/');
$matcher = new UrlMatcher($routes, $context);
$generator = new UrlGenerator($routes, $context);

// Генерация URL для категории с id=10 и slug='phones'
$url = $generator->generate('category_show', ['id' => 10, 'slug' => 'phones']);
echo $url; // /category/10/phones

// Matching запроса
$uri = '/category/15/tablets';
$parameters = $matcher->match($uri);
// $parameters = ['_controller' => 'show', 'id' => '15', 'slug' => 'tablets', '_route' => 'category_show']

Вывод: /category/10/phones (результат генерации)
После matching: массив с параметрами 15 и tablets.

Пример 4: Вложенные категории с NestedSet (пакет Kalnoy).

// Миграция для таблицы categories
Schema::create('categories', function (Blueprint $table) {
    $table->id();
    $table->string('slug')->unique();
    $table->nestedSet(); // добавляет _lft, _rgt, parent_id
    $table->timestamps();
});

// Модель Category (использует trait)
use Kalnoy\Nestedset\NodeTrait;
class Category extends Model {
    use NodeTrait;
    public function getRouteKeyName() { return 'slug'; }
}

// Маршрут
Route::get('/category/{path}', function ($path) {
    $slugs = explode('/', $path);
    $lastSlug = end($slugs);
    $category = Category::whereSlug($lastSlug)->firstOrFail();
    // Проверка, что ancestors совпадают с переданными slug
    $ancestors = $category->ancestors()->pluck('slug')->toArray();
    $expected = array_slice($slugs, 0, -1);
    if ($ancestors !== $expected) {
        return redirect('/category/' . implode('/', $ancestors) . '/' . $category->slug, 301);
    }
    return view('category.show', compact('category'));
})->where('path', '.*');

При запросе /category/electronics/phones (где Phones дочерняя от Electronics) выводится страница категории Phones.
Если запрос /category/computers/phones и Phones не является дочерней Computers, происходит редирект на правильный путь.

Пример 5: Тестирование маршрута категории с помощью PHPUnit (Laravel).

public function test_category_route_returns_successful_response()
{
    $category = Category::factory()->create(['slug' => 'test-cat']);
    $response = $this->get('/category/' . $category->id . '/test-cat');
    $response->assertStatus(200);
    $response->assertSee($category->name);
}

public function test_category_route_with_wrong_slug_redirects()
{
    $category = Category::factory()->create(['slug' => 'correct-slug']);
    $response = $this->get('/category/' . $category->id . '/wrong-slug');
    $response->assertRedirect('/category/' . $category->id . '/correct-slug');
}

Первый тест проходит: HTTP 200, страница содержит имя категории.
Второй тест проходит: HTTP 301 редирект на правильный URL.