Перевести 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.