alexpts/php-simple-router

Simple router compatible with the PSR-7

1.0.0 2023-05-09 14:38 UTC

This package is auto-updated.

Last update: 2024-10-09 17:41:37 UTC


README

phpunit codecov Simple router compatible with the PSR-7

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

Router

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

$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 возвращает массив всех роутов отсортированных по приоритету.

Matcher

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

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

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

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

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

EndPoint

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

CallablePoint

Предназначен для вызова любого обработчика callable типа.

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

Явно задает класс контроллера и метод.

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

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

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

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

$endPoint = new Point\ControllerDynamicAction([
	'controller' => SomeController::class
]);
Создавайте новые endPoint

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