PHP code example of triangle / router

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

triangle / router example snippets

atcher = simpleRouteDispatcher(function(Triangle\Router\RouteCollector $r) {
    $r->addRoute('GET', '/users', 'get_all_users_handler');
    // {id} должен быть числом (\d+)
    $r->addRoute('GET', '/user/{id:\d+}', 'get_user_handler');
    // Суффикс /{title} не обязателен
    $r->addRoute('GET', '/articles/{id:\d+}[/{title}]', 'get_article_handler');
});

// Получаем метод и URI откуда нужно
$httpMethod = $_SERVER['REQUEST_METHOD'];
$uri = $_SERVER['REQUEST_URI'];

// Удалим строку запроса (?foo=bar) и декодируем URI
if (false !== $pos = strpos($uri, '?')) {
    $uri = substr($uri, 0, $pos);
}
$uri = rawurldecode($uri);

$routeInfo = $dispatcher->dispatch($httpMethod, $uri);
switch ($routeInfo[0]) {
    case Triangle\Router\Dispatcher::NOT_FOUND:
        // ... 404 Ничего не найдено
        break;
    case Triangle\Router\Dispatcher::METHOD_NOT_ALLOWED:
        $allowedMethods = $routeInfo[1];
        // ... 405 Метод не поддерживается
        break;
    case Triangle\Router\Dispatcher::FOUND:
        $callback = $routeInfo[1];
        $vars = $routeInfo[2];
        // ... Здесь можно вызвать, например $callback($vars)
        break;
}

$r->addRoute($method, $routePattern, $handler);

// 2 маршрута:
$r->addRoute('GET', '/test', 'handler');
$r->addRoute('POST', '/test', 'handler');
// Эквивалентны записи:
$r->addRoute(['GET', 'POST'], '/test', 'handler');

// Маршрут /user/42 совпадёт, но /user/xyz - уже нет
$r->addRoute('GET', '/user/{id:\d+}', 'handler');

// Маршрут /user/foobar совпадёт, но /user/foo/bar  - уже нет
$r->addRoute('GET', '/user/{name}', 'handler');

// Маршрут /user/foo/bar совпадёт
$r->addRoute('GET', '/user/{name:.+}', 'handler');

// Этот маршрут
$r->addRoute('GET', '/user/{id:\d+}[/{name}]', 'handler');
// Эквивалентен двум следующим
$r->addRoute('GET', '/user/{id:\d+}', 'handler');
$r->addRoute('GET', '/user/{id:\d+}/{name}', 'handler');

// Также возможны множественные вложенные необязательные части
$r->addRoute('GET', '/user[/{id:\d+}[/{name}]]', 'handler');

// Этот маршрут НЕ действителен, поскольку необязательные части могут встречаться только в конце
$r->addRoute('GET', '/user[/{id:\d+}]/{name}', 'handler');

$r->get('/get-route', 'get_handler');
$r->post('/post-route', 'post_handler');

$r->addRoute('GET', '/get-route', 'get_handler');
$r->addRoute('POST', '/post-route', 'post_handler');

$r->any('/any-route', 'any_handler');

$r->addGroup('/admin', function (RouteCollector $r) {
    $r->addRoute('GET', '/do-something', 'handler');
    $r->addRoute('GET', '/do-another-thing', 'handler');
    $r->addRoute('GET', '/do-something-else', 'handler');
});

$r->addRoute('GET', '/admin/do-something', 'handler');
$r->addRoute('GET', '/admin/do-another-thing', 'handler');
$r->addRoute('GET', '/admin/do-something-else', 'handler');
 

$dispatcher = cachedRouteDispatcher(function(Triangle\Router\RouteCollector $r) {
    $r->addRoute('GET', '/user/{name}/{id:[0-9]+}', 'handler0');
    $r->addRoute('GET', '/user/{id:[0-9]+}', 'handler1');
    $r->addRoute('GET', '/user/{name}', 'handler2');
}, [
    'cacheFile' => __DIR__ . '/route.cache', /* обязательно */
    'cacheDisabled' => IS_DEBUG_ENABLED,     /* необязательно, включено по умолчанию */
]);

namespace Triangle\Router;

interface RouteParser {
    public function parse($route);
}

interface DataGenerator {
    public function addRoute($httpMethod, $routeData, $handler);
    public function getData();
}

interface Dispatcher {
    const NOT_FOUND = 0, FOUND = 1, METHOD_NOT_ALLOWED = 2;

    public function dispatch($httpMethod, $uri);
}

$dispatcher = simpleRouteDispatcher(function(Triangle\Router\RouteCollector $r) {
    /* ... */
}, [
    'routeParser' => 'Triangle\\Router\\RouteParser\\Std',
    'dataGenerator' => 'Triangle\\Router\\DataGenerator\\GroupCountBased',
    'dispatcher' => 'Triangle\\Router\\Dispatcher\\GroupCountBased',
]);