Перевести путь в URI Path::convertLogicalToUri
Модуль: main — подключать отдельно не нужно
Метод Path::convertLogicalToUri переводит путь от корня сайта в URI. Метод кодирует каждую часть пути функцией rawurlencode и сохраняет косые черты.
Сигнатура метода в классе Bitrix\Main\IO\Path:
public static function convertLogicalToUri($path)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| path* | string |
Задает путь в кодировке UTF-8 |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод возвращает URI. Метод кодирует пробел как %20, кириллицу — байтами UTF-8, например %D0%B5.
Особенности
Если имя файла — индексный файл каталога, метод убирает его и оставляет косую черту. Например, для /units/index.php метод вернет /units/. Список индексных файлов задает секция directory_index в конфигурации ядра. Ключи массива — имена файлов. Без секции метод берет index.php, index.html, index.htm, index.phtml, default.html и index.php3.
Примеры
Пример. Код переводит в URI путь с пробелом и путь к индексному файлу:
<?php
use Bitrix\Main\IO\Path;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
echo Path::convertLogicalToUri('/upload/units list/kg.txt') . ' ' . Path::convertLogicalToUri('/units/index.php');
Код выведет /upload/units%20list/kg.txt /units/.