# Router::setRouteHandler()

URL: https://chugunov.pro/api-bitrix/main/urlpreview/router/setroutehandler/
Проверено на 1С-Битрикс 25.x, обновлено 03.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией 1С-Битрикс.

Класс: [`\Bitrix\Main\UrlPreview\Router`](https://chugunov.pro/api-bitrix/main/urlpreview/router/)
Модуль: Main.
Свойства элемента: method, public, static.

## Сигнатура

```php
public static setRouteHandler(string $route, string $handlerModule, string $handlerClass, array<string|int, mixed> $handlerParameters) : void
```

## Описание

Добавляет или, если маршрут уже существует, изменяет метод обработки маршрута.

## Параметры

- `$route` `string` — обязательный. Шаблон URL маршрута.
  Параметры маршрута следует заключать в символы решётки, например '/user/#userId#/'.
- `$handlerModule` `string` — обязательный. Модуль обработчика маршрута.
- `$handlerClass` `string` — обязательный. Класс обработчика маршрута должен реализовывать методы:
  
  buildPreview($params): string. Метод должен принимать массив параметров и возвращать отрендеренный предпросмотр
  
  checkUserReadAccess($params): boolean. Метод должен принимать массив параметров. Метод должен возвращать true, если
  текущий авторизованный пользователь имеет доступ на чтение к сущности; false в противном случае.
  
  getCacheTag(): string. Метод должен возвращать тег кеша для сущности.
  
  .
- `$handlerParameters` `array<string|int, mixed>` — обязательный. Массив параметров, передаваемых методам обработчика.
  Будет передан в качестве аргумента при вызове метода обработчика для построения предпросмотра или проверки доступа.
  Значения массива могут содержать переменные, ссылающиеся на параметры маршрута.
  например ['userId' => '$userId'].

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

`void`

Оригинал в официальной документации: https://docs.1c-bitrix.ru/api/classes/Bitrix-Main-UrlPreview-Router.html