Организация маршрута /checkout в PHP проектах

Расширенные примеры реализации маршрута /checkout

Пример 1: FastRoute с поддержкой middleware и контроллером

Установка через Composer: composer require nikic/fast-route

Создание контроллера CheckoutController.php

<?php
class CheckoutController
{
    public function index()
    {
        // Рендерим форму заказа
        require_once 'views/checkout_form.php';
    }

    public function process()
    {
        // Обработка POST-данных
        $data = $_POST;
        // Валидация, сохранение в БД
        header('Location: /checkout/success');
    }
}
?>

Файл index.php с middleware для логирования

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

// Middleware-функция
$logMiddleware = function ($request) {
    $log = date('Y-m-d H:i:s') . ' ' . $request['method'] . ' ' . $request['uri'] . PHP_EOL;
    file_put_contents('access.log', $log, FILE_APPEND);
};

$dispatcher = FastRoute\simpleDispatcher(function(FastRoute\RouteCollector $r) {
    $r->addRoute('GET', '/checkout', 'CheckoutController@index');
    $r->addRoute('POST', '/checkout', 'CheckoutController@process');
});

$httpMethod = $_SERVER['REQUEST_METHOD'];
$uri = $_SERVER['REQUEST_URI'];
$uri = (false !== $pos = strpos($uri, '?')) ? substr($uri, 0, $pos) : $uri;
$uri = rawurldecode($uri);

$routeInfo = $dispatcher->dispatch($httpMethod, $uri);

// Вызов middleware
$logMiddleware(['method' => $httpMethod, 'uri' => $uri]);

switch ($routeInfo[0]) {
    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;
    default:
        header('HTTP/1.1 404');
        echo 'Not found';
}
?>

Результат: при каждом запросе к /checkout в файл access.log добавляется строка с временем, методом и URI.

2025-03-18 14:23:45 GET /checkout
2025-03-18 14:24:01 POST /checkout

Пример 2: Ручная маршрутизация с поддержкой параметров через explode

Подходит, когда нет возможности использовать внешние библиотеки. Парсим URL и извлекаем сегменты.

<?php
$uri = $_SERVER['REQUEST_URI'];
$uri = trim($uri, '/');
$segments = explode('/', $uri);

// /checkout -> ['checkout']
// /checkout/order/123 -> ['checkout', 'order', '123']

$controllerName = isset($segments[0]) ? $segments[0] : 'home';
$action = isset($segments[1]) ? $segments[1] : 'index';
$params = array_slice($segments, 2);

switch ($controllerName) {
    case 'checkout':
        require_once 'controllers/CheckoutController.php';
        $controller = new CheckoutController();
        if (method_exists($controller, $action)) {
            call_user_func_array([$controller, $action], $params);
        } else {
            echo 'Action not found';
        }
        break;
    default:
        // 404
        break;
}
?>

Пример 3: .htaccess для Nginx (альтернатива)

Для серверов Nginx конфигурация отличается. Пример для виртуального хоста:

server {
    listen 80;
    server_name example.com;
    root /var/www/html;

    location / {
        try_files $uri $uri/ /index.php?route=$uri&$args;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Результат: все запросы, не соответствующие существующим файлам, перенаправляются на index.php с параметром route.

Пример 4: Использование AltoRouter (лёгкая библиотека)

Установка: composer require altorouter/altorouter

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

$router = new AltoRouter();

$router->map('GET|POST', '/checkout', function() {
    require 'checkout_handler.php';
});

$router->map('GET', '/checkout/order/[i:id]', function($id) {
    echo "Показываем заказ номер: " . htmlspecialchars($id);
});

$match = $router->match();

if ($match && is_callable($match['target'])) {
    call_user_func_array($match['target'], $match['params']);
} else {
    header($_SERVER["SERVER_PROTOCOL"] . ' 404 Not Found');
    echo 'Страница не найдена';
}
?>

AltoRouter предлагает простой синтаксис с поддержкой типов параметров ([i:id] – целое число).

Результат:

URL /checkout/order/42 -> выведет "Показываем заказ номер: 42"