CBXVirtualIo

Bitrix Framework support of other than English symbols in the public filenames applies certain limits on general work, specifically:
Direct calls are unavailable

• to file names selected by users,
• to folder names selected by users,
• to files and folders located in folders which names are selected by users.

For example, the file .access.php cannot be directly called because it can be located in the Folder folder: /Folder/.access.php.

If the call is directed to the file inside the /bitrix folder, it is the service area that should not contain non-English characters. Direct methods can be used. If the request to item is made outside /bitrix folder, then either a name, or path can contain non-English characters. Also, CBXVirtualIo must be used.
Exception - widespread files inside site root: /404.php, /auth.php, /urlrewrite.php, /.htaccess, which, obviously cannot support non-English characters in the path, though they are located not in the /bitrix folder.

CBXVirtualIo class is used to handle files in public section, which are created by users, or user-created folders.

This class is not static, that's why it is recommended to create its instance before using it. To get "default" instance of CBXVirtualIo class, use the static method GetInstance(). This method creates a single class instant with "default" settings only once, when called for the first time:

$io = CBXVirtualIo::GetInstance();

Class methods

string 
CBXVirtualIo::GetPhysicalName(
 string $path
);

string 
CBXVirtualIo::GetLogicalName(
 string $path
);

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

void 
CBXVirtualIo::ClearCache(
);

array  
CBXVirtualIo::GetErrors(
);