Получить значения параметров маршрута Route::getParametersValues

Модуль: main — подключать отдельно не нужно

Метод Route::getParametersValues возвращает значения всех параметров маршрута. Метод Router::match заполняет значения, когда находит маршрут для запроса.

Сигнатура метода в классе Bitrix\Main\Routing\Route:

public function getParametersValues()

Возвращаемое значение

Метод возвращает объект Bitrix\Main\Type\Dictionary. Ключи — имена параметров, значения — строки из пути или значения по умолчанию из настроек маршрута. Метод getValues объекта возвращает массив значений, метод isEmpty проверяет, есть ли значения.

Если метод Router::match не заполнил значения, метод возвращает пустой объект. Метод создает его при первом вызове.

Файл /bitrix/routing_index.php копирует значения в $_GET и $_REQUEST перед вызовом обработчика.

Примеры

Пример. Код находит маршрут для запроса и выводит значения параметров:

<?php
use Bitrix\Main\HttpRequest;
use Bitrix\Main\Routing\Router;
use Bitrix\Main\Routing\RoutingConfigurator;
use Bitrix\Main\Server;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$router = new Router();
$routes = new RoutingConfigurator();
$routes->setRouter($router);

$routes
    ->get('/units/{code}/', static fn() => 'unit')
    ->default('view', 'short')
;
$router->releaseRoutes();

$server = new Server([
    'REQUEST_URI' => '/units/kg/',
    'REQUEST_METHOD' => 'GET',
    'QUERY_STRING' => '',
]);
$request = new HttpRequest($server, [], [], [], []);

$route = $router->match($request);

var_export($route?->getParametersValues()->getValues());

Код выведет:

array (
  'code' => 'kg',
  'view' => 'short',
)

Смотрите также