Расширенные примеры маршрутов продуктов

Пример 1. Вложенные ресурсы с пагинацией и фильтрацией через сегменты URL

Маршрут: /api/v2/categories/{catId}/products?status=active&limit=10 и /api/v2/categories/{catId}/products/{prodId}

// FastRoute
$r->addGroup('/api/v2/categories/{catId:\d+}', function (RouteCollector $r) {
    $r->addGroup('/products', function (RouteCollector $r) {
        $r->addRoute('GET', '', 'CategoryProductController::index');
        $r->addRoute('GET', '/{prodId:\d+}', 'CategoryProductController::show');
        $r->addRoute('POST', '', 'CategoryProductController::store');
    });
});

В контроллере:

class CategoryProductController {
    public function index($catId) {
        $status = $_GET['status'] ?? 'all';
        $limit  = (int)($_GET['limit'] ?? 20);
        // выборка продуктов из категории $catId с фильтрацией
        echo "Категория $catId, статус $status, лимит $limit";
    }
    public function show($catId, $prodId) {
        echo "Продукт $prodId из категории $catId";
    }
}

Результат вызова GET /api/v2/categories/5/products?status=active:

Категория 5, статус active, лимит 20

Пример 2. Использование именованных маршрутов для генерации URL продуктов

FastRoute не поддерживает именованные маршруты напрямую, но можно реализовать через хранение в массиве. В Symfony Routing это встроено.

// Симфони роутинг
$route = new Route('/products/{id}', [
    '_controller' => 'ProductController::show',
], ['id' => '\d+']);
$route->setMethods(['GET']);
$routes->add('product_show', $route);

// Генерация URL
use Symfony\Component\Routing\Generator\UrlGenerator;
$generator = new UrlGenerator($routes, new RequestContext());
echo $generator->generate('product_show', ['id' => 42]);

/products/42

Пример 3. Маршруты с middleware для проверки прав доступа к продуктам

В самописном решении middleware оборачивает обработчик:

function authMiddleware(callable $handler) {
    return function (...$params) use ($handler) {
        if (!isset($_SESSION['user'])) {
            header('HTTP/1.1 401 Unauthorized');
            exit('Требуется авторизация');
        }
        return $handler(...$params);
    };
}

$routes = [
    'GET /products' => authMiddleware('ProductController::index'),
    'POST /products' => authMiddleware('ProductController::store'),
];

Проблема: сложно компоновать несколько middleware. Решение - использовать цепочку вызовов или библиотеку Middleware.

Пример 4. Обработка ошибок 404 для несуществующих продуктов с кастомной страницей

$r->addRoute('GET', '/products/{id:\d+}', function ($id) {
    $product = findProductById($id);
    if (!$product) {
        // выбросить исключение или вернуть 404
        http_response_code(404);
        echo json_encode(['error' => 'Продукт не найден']);
        return;
    }
    echo json_encode($product);
});

Более продвинутый способ - использовать middleware для отлова исключений:

class NotFoundException extends \Exception {}

$container = function($uri, $method) {
    try {
        // диспетчеризация маршрута
    } catch (NotFoundException $e) {
        header('HTTP/1.1 404 Not Found');
        echo '
404 - Продукт не найден
';
    }
};

Пример 5. Маршруты для массовых операций над продуктами (batch)

Маршрут POST /products/batch для массового создания/обновления:

$r->addRoute('POST', '/products/batch', 'ProductController::batchStore');

// в контроллере
function batchStore() {
    $data = json_decode(file_get_contents('php://input'), true);
    foreach ($data as $product) {
        // сохранение
    }
    echo 'Обработано ' . count($data) . ' продуктов';
}

Вызов curl -X POST -H "Content-Type: application/json" -d '[{"name":"A"},{"name":"B"}]' http://example.com/products/batch

Обработано 2 продуктов

Пример 6. Динамический роутинг продуктов на основе slug вместо id

$r->addRoute('GET', '/products/{slug:[a-z0-9-]+}', 'ProductController::showBySlug');

function showBySlug($slug) {
    $product = getProductBySlug($slug);
    if (!$product) {
        http_response_code(404);
        echo 'Продукт с таким URL не найден';
        return;
    }
    echo "Продукт: {$product['name']}";
}

Ошибка: забыть экранировать дефис в регулярном выражении. Правильно: [a-z0-9-]+ - дефис должен быть в конце или начале, иначе интерпретируется как диапазон.

Пример 7. Разделение маршрутов для админки и публичного API продуктов

$r->addGroup('/admin', function (RouteCollector $r) {
    $r->addGroup('/products', function (RouteCollector $r) {
        $r->addRoute('GET', '', 'Admin\ProductController::index');
        $r->addRoute('POST', '', 'Admin\ProductController::store');
    });
});

$r->addGroup('/api', function (RouteCollector $r) {
    $r->addGroup('/products', function (RouteCollector $r) {
        $r->addRoute('GET', '', 'Api\ProductController::index');
    });
});

Разные пространства имён контроллеров упрощают поддержку.