Перевести путь из кодировки файловой системы в UTF-8 Path::convertPhysicalToLogical

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

Метод Path::convertPhysicalToLogical переводит путь из кодировки файловой системы в кодировку сайта UTF-8. Вызывайте метод для путей, которые вернули функции PHP, например scandir, прежде чем выводить путь на страницу или записывать его в базу данных.

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

public static function convertPhysicalToLogical($path)

Параметры

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

Параметр Тип Описание
path* string Задает путь в кодировке файловой системы

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

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

Метод возвращает путь в кодировке UTF-8. Если кодировки совпадают, метод возвращает путь без изменений. Кодировку файловой системы метод определяет так же, как convertLogicalToPhysical.

Примеры

Пример. Код выводит в кодировке UTF-8 имена из каталога модуля main, которые начинаются с include:

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

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

$directory = Path::convertLogicalToPhysical($_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main');
$names = scandir($directory);

if ($names !== false)
{
    foreach ($names as $name)
    {
        if (str_starts_with($name, 'include'))
        {
            echo Path::convertPhysicalToLogical($name) . PHP_EOL;
        }
    }
}

Код выведет:

include
include.php

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