Документация

Маски путей

Список заполняется по одному пути на строку. Разделителем считается и точка с запятой — так же, как в списках путей самого Битрикса.

Подстановки

Их две, и они те же, что в композитном кэше и в правилах адресов Битрикса:

Знак Что заменяет
* любые символы, включая косую черту
? ровно один любой символ

Маска сравнивается с путём целиком. Поэтому путь без подстановок означает точное совпадение, а для «этого раздела и всего, что внутри» нужна звёздка в конце.

Маска Совпадает Не совпадает
/contacts/feedback/ /contacts/feedback/ /contacts/feedback/thanks/
/auth/* /auth/, /auth/register/, /auth/forgot/password/ /authors/
/personal/*/edit/ /personal/profile/edit/, /personal/orders/2024/edit/ /personal/edit/
/page-?.php /page-1.php, /page-a.php /page-12.php

Что сравнивается

Сравнивается путь запроса — то, что стоит до знака вопроса.

  • Параметры адреса не участвуют: маска /search/ совпадёт и с /search/?q=окна.
  • Регистр не учитывается: /Catalog/ и /catalog/ для маски одно и то же.
  • Домен и протокол в маске не пишутся: путь начинается с косой черты.

Частая ошибка

Раздел без звёздки закрывает только сам адрес раздела. Список

/personal/

оставит капчу на странице /personal/, но не на /personal/profile/. Правильная запись для раздела целиком:

/personal/
/personal/*

Первая строка — сам раздел, вторая — всё, что внутри.