Маршрутизация (Router)

← Назад к разделу «Ядро»

App\Common\Router — лёгкий HTTP-роутер: сопоставляет путь и метод запроса с обработчиком. В панели управления маршруты модулей объявляются в их routes.php.

Объявление маршрутов

use App\Common\Router;
use App\Adminx\Notes\Controller;

Router::get('/notes',            array(Controller::class, 'index'));
Router::post('/notes',           array(Controller::class, 'store'));
Router::post('/notes/{id}',      array(Controller::class, 'update'));
Router::post('/notes/{id}/pin',  array(Controller::class, 'togglePin'));
Router::delete('/notes/{id}',    array(Controller::class, 'delete'));

Методы: get, post, put, delete, any — все принимают ($pattern, $handler).

Параметры пути `{name}`

Фрагменты в фигурных скобках становятся именованными параметрами и приходят обработчику первым аргументом — массивом $params.

Router::get('/documents/{id}/edit', array(Controller::class, 'edit'));

public function edit(array $params = array())
{
    $id = isset($params['id']) ? (int) $params['id'] : 0;
    // ...
}

Типы обработчиков

Тип	Пример
`[class, method]`	`array(Controller::class, 'index')` — самый частый
`Closure`	`function (array $params) { ... }`
`string`	путь к PHP-файлу (include выполняет вызывающий код)

Router::get('/ping', function () { return 'pong'; });

Группы маршрутов

group($prefix, callable $fn) — общий префикс для набора маршрутов.

Router::group('/catalog', function () {
    Router::get('/products',        array(Ctrl::class, 'products'));
    Router::get('/products/{id}',   array(Ctrl::class, 'product'));
});
// → /catalog/products, /catalog/products/{id}

Сопоставление и метод-override

Router::match($path = null, $method = null) возвращает ['handler' => ..., 'params' => [...]] или null. По умолчанию берёт путь и метод из $_SERVER.

Поддерживается _method-override: HTML-форма может послать PUT/DELETE/PATCH через POST со скрытым полем _method.

<form method="post" action="/documents/5">
  <input type="hidden" name="_method" value="DELETE">
</form>

Отладка

Router::routes();   // все зарегистрированные маршруты
Router::reset();    // очистить (в тестах)

В панели управления сопоставление и вызов обработчика делает App\Common\Dispatcher поверх Router — модулю достаточно объявить маршруты в routes.php.

3.1 KiB Raw Blame History