alexpts/php-simple-router

Simple router compatible with the PSR-7

php-simple-router

Simple router compatible with the PSR-7, _(*1)

Роутер предназначен для передачи управления обработчику запроса по входному http запросу. Весь роутинг делиться на небольшие компоненты, которые занимаются определенной задачей., _(*2)

Router

Объект, который храни в себе путь/регулярку и ряд ограничений на http метод или переменную запроса, а также обработчик, который нужно вызвать для этого пути., _(*3)

$route2 = new Route('/blog/{id}/', $endPoint2, ['id' => '\d+']);

$route = new Route('/{lang}/users/{id}/{action}/', $endPoint, [
    'lang' => 'ru|en',
    'action' => '[a-z0-9_]+',
    'id' => '\d+',
], Route::ONLY_XHR);

CollectionRoute

Объект для работы с коллекцией роутов. Роуты добавляются в коллекцию роутов с определенным приоритетом. Метод getRoutes возвращает массив всех роутов отсортированных по приоритету., _(*4)

Matcher

Объект осуществляет поиск активного роута на основе соллекции роутов и текущего uri запроса. Простой поиск первого совпадения (наиболее приоритетного роута):, _(*5)

$matcher = new Matcher();
$uri = '/profile/23/';
$routes = ...; // CollectionRoute instance
$endPoint = $matcher->matchFirst($routes, $uri); // IPoint instance

Можно получить все endPoint объекты, а не только первый. Метод match возвращает генератор. Через генератор достаются все объекты endPoint совпавших роутов., _(*6)

 foreach ($matcher->match($routes, $uri) as $endPoint) {
    ...
 }

Брагодаря такой конструкции, можно выполнять маленькие обработчики друг за другом и др., _(*7)

EndPoint

Все обработчики поддерживают интерфейс IPoint и служат для создания обработчика запроса с нужными параметрами и вызова обработчика с нужными параметрами. В комплекте идет ряд реализаций endPoint, которые могут помочь коротко и лаконично описать правила роутинга вашего приложения., _(*8)

CallablePoint

Предназначен для вызова любого обработчика callable типа., _(*9)

$endPoint = new Point\CallablePoint([
    'callable' => function () {
        return '404';
    }
]);

ControllerPoint

Явно задает класс контроллера и метод., _(*10)

$endPoint = new Point\ControllerPoint([
    'controller' => 'CollectionRouteTest',
    'action' => 'action'
]);

DynamicController

Класс контроллера формируется динамически из переменной запрос :controller, которая является обязательной. Action берется из переменной запроса :action (по умолчанию index), _(*11)

$endPoint = new Point\DynamicController([
    'prefix' => 'Demo'
]);

ControllerDynamicAction

Похож на DynamicController за исключением того, что контрллер указывается явно, а не берется динамически из переменной запроса :controller., _(*12)

$endPoint = new Point\ControllerDynamicAction([
    'controller' => SomeController::class
]);

Создавайте новые endPoint

Охватить специфику каждого проекта очень сложно и это будет избыточно. Вы можете легко создать более специфичный класс типа IPoint на основе базовых классов или с нуля. Примером такого класса для своего проекта служит класс DynamicBundleController. Он призван показать как легко и просто делаются endPoint-ы под свой проект, если дефолтные по какой-то причине не подошли., _(*13)