Раскодировать строку адреса Uri::urnDecode
Модуль: main — подключать отдельно не нужно
Статический метод Uri::urnDecode раскодирует строку адреса без разбора на части. Метод раскодирует функцией rawurldecode текст между разделителями ://, :порт/, /, ?, = и &. Метод выполняет обратное преобразование к urnEncode.
Сигнатура метода в классе Bitrix\Main\Web\Uri:
public static function urnDecode($str, $charset = false)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| str* | string |
Задает закодированный адрес |
| charset | string или false |
Задает кодировку исходного текста. По умолчанию — false, без перевода. Подробнее — в разделе «Особенности» |
Типы в таблице описывают назначение аргументов. Сигнатура PHP не объявляет их.
Возвращаемое значение
Метод возвращает раскодированную строку.
Особенности
- Метод не меняет
+на пробел, в отличие отurldecode. - Если
charsetотличается от кодировки сайта, метод перекодирует часть строки до раскодирования. Последовательности%XXсостоят из латиницы, поэтому перекодировка на них не влияет, и раскодированный текст остается в исходной кодировке. Если нужна кодировка сайта, перекодируйте результат отдельно. - В более ранних версиях, например 26.150.0, значение
charsetпо умолчанию —'UTF-8'. На сайте в UTF-8 результат тот же.
Примеры
Пример. Код раскодирует путь к файлу:
<?php
use Bitrix\Main\Web\Uri;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
echo Uri::urnDecode('/docs/report%202025.pdf?lang=ru');
Код выведет /docs/report 2025.pdf?lang=ru.
Смотрите также
Была ли статья полезна?
Предыдущая
Следующая