Перевести путь в кодировку файловой системы Path::convertLogicalToPhysical
Модуль: main — подключать отдельно не нужно
Метод Path::convertLogicalToPhysical переводит путь из кодировки сайта UTF-8 в кодировку файловой системы. Вызывайте метод перед функциями PHP, которые работают с файлами, если в именах файлов есть нелатинские символы.
Сигнатура метода в классе Bitrix\Main\IO\Path:
public static function convertLogicalToPhysical($path)
Параметры
Обязательные параметры обозначены *
| Параметр | Тип | Описание |
|---|---|---|
| path* | string |
Задает путь в кодировке UTF-8 |
Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.
Возвращаемое значение
Метод возвращает путь в кодировке файловой системы. Если кодировки совпадают, метод возвращает путь без изменений.
Особенности
Кодировку файловой системы задает константа BX_FILE_SYSTEM_ENCODING. Без константы метод считает кодировкой windows-1251 в Windows и utf-8 в остальных системах. Метод запоминает кодировки при первом вызове.
Примеры
Пример. Код переводит путь с кириллицей в кодировку файловой системы и проверяет, есть ли файл:
<?php
use Bitrix\Main\IO\Path;
require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
$physicalPath = Path::convertLogicalToPhysical($_SERVER['DOCUMENT_ROOT'] . '/upload/единицы.txt');
echo file_exists($physicalPath) ? 'exists' : 'not found';
Если файла нет, код выведет not found.