Перевести URI в путь в кодировке файловой системы Path::convertUriToPhysical

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

Метод Path::convertUriToPhysical переводит URI в путь в кодировке файловой системы. Метод декодирует каждую часть функцией rawurldecode и переводит результат из UTF-8 в кодировку файловой системы, если они различаются.

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

public static function convertUriToPhysical($path)

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
path* string Задает путь из URI без домена и строки запроса

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

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

Метод возвращает путь. Метод не нормализует путь и не проверяет части ... Прежде чем открыть файл, переведите путь в абсолютный методом convertRelativeToAbsolute и проверьте, что результат начинается с нужного каталога.

Примеры

Пример. Код переводит URI с закодированным пробелом в путь:

<?php
use Bitrix\Main\IO\Path;

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

echo Path::convertUriToPhysical('/upload/units%20list/kg.txt');

На сервере с кодировкой файловой системы UTF-8 код выведет /upload/units list/kg.txt.

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