CBXVirtualIo

Описание

Поддержка Bitrix Framework русских (и прочих) символов в названиях публичных файлов накладывает определённые ограничения на работу:
недопустимы прямые вызовы

• к файлам, имена которых выбираются пользователями,
• к папкам, имена которых выбираются пользователями,
• к файлам и папкам, которые могут лежать в папках, имена которых выбираются пользователями.

Например, нельзя напрямую обратиться к файлу .access.php потому, что он может лежать в папке Папка: /Папка/.access.php.

Если обращение идет к файлу внутри папки /bitrix, то это служебная область и там не должно быть кириллицы. Можно использовать прямые методы. Если обращение вне папки /bitrix, то либо в имени, либо в пути могут быть русские буквы. И нужно пользоваться CBXVirtualIo.
Исключение - известные нам файлы в корне сайта: /404.php, /auth.php, /urlrewrite.php, /.htaccess, которые очевидно не могут подержать в пути кириллицу, хотя они и не в папке /bitrix.

CBXVirtualIo - класс для работы с файлами публичной части, которые создаются пользователями или лежат в папках, создаваемых пользователями.

Это не статический класс, поэтому перед использованием необходимо создать его экземпляр. Для получения экземпляра "по-умолчанию" класса CBXVirtualIo следует использовать статический метод GetInstance(). Этот метод создает экземпляр класса с настройками "по-умолчанию" только один раз при первом обращении:

$io = CBXVirtualIo::GetInstance();

Список методов

string 
CBXVirtualIo::GetPhysicalName(
	 string $path
);

string 
CBXVirtualIo::GetLogicalName(
	 string $path
);

resource 
CBXVirtualIo::OpenFile(
	 string $path,
	 string $mode
);

void 
CBXVirtualIo::ClearCache(
);

array  
CBXVirtualIo::GetErrors(
);