Работа с файлами и директориями в D7: Классы File, Directory и Path

Классические PHP-функции (file_get_contents, mkdir, unlink) отлично работают, но они не предоставляют объектного интерфейса и не всегда корректно обрабатывают особенности путей и кодировок в Битрикс.

Ядро D7 предлагает набор классов в пространстве имен \Bitrix\Main\IO для унифицированной и безопасной работы с файловой системой.

1. Класс \Bitrix\Main\IO\Path — работа с путями

Этот класс содержит статические методы для манипуляции со строками путей, не обращаясь к реальной файловой системе.

use Bitrix\Main\IO\Path;

$path = "/path/to/some/file.txt";

// Получить имя файла
echo Path::getName($path); // file.txt

// Получить имя файла без расширения
echo Path::getFilename($path); // file

// Получить расширение
echo Path::getExtension($path); // txt

// Получить путь к директории
echo Path::getDirectory($path); // /path/to/some

// Нормализовать путь (убирает двойные слэши, точки и т.д.)
$dirtyPath = "/path//to/../file.txt";
echo Path::normalize($dirtyPath); // /path/file.txt

2. Класс \Bitrix\Main\IO\File — работа с файлами

Этот класс представляет конкретный файл на диске.

Создание объекта и проверка существования:

use Bitrix\Main\IO\File;
use Bitrix\Main\Application;

$documentRoot = Application::getInstance()->getContext()->getServer()->getDocumentRoot();
$filePath = $documentRoot . "/my_file.txt";

$file = new File($filePath);

if ($file->isExists()) {
    echo "Файл существует. Размер: " . $file->getSize() . " байт.";
} else {
    echo "Файл не существует.";
}

Чтение и запись:
Методы getContents() и putContents() — это объектно-ориентированные и безопасные аналоги file_get_contents и file_put_contents.

// Запись в файл (если файла нет, он будет создан)
$file->putContents("Hello, D7!");

// Чтение из файла
$content = $file->getContents();
echo $content; // Hello, D7!

// Добавление в конец файла
$file->putContents(" World!", File::APPEND);

Другие полезные методы:

• $file->delete(): удаляет файл.
• $file->rename($newName): переименовывает файл.
• $file->getModificationTime(): возвращает timestamp последнего изменения.

3. Класс \Bitrix\Main\IO\Directory — работа с директориями

Аналогично классу File, этот класс представляет директорию на диске.

Создание и проверка:

use Bitrix\Main\IO\Directory;
use Bitrix\Main\Application;

$dirPath = Application::getInstance()->getContext()->getServer()->getDocumentRoot() . "/my_dir/";
$directory = new Directory($dirPath);

if (!$directory->isExists()) {
    // Создаем директорию, если ее нет
    $directory->create();
}

Получение списка дочерних элементов:
Метод getChildren() возвращает массив объектов File и Directory.

if ($directory->isExists()) {
    $children = $directory->getChildren();
    
    foreach ($children as $child) {
        if ($child instanceof \Bitrix\Main\IO\Directory) {
            echo "Папка: " . $child->getName() . "<br>";
        } elseif ($child instanceof \Bitrix\Main\IO\File) {
            echo "Файл: " . $child->getName() . "<br>";
        }
    }
}

Другие полезные методы:

• $directory->delete(): удаляет директорию (должна быть пустой).
• $directory->isWritable(): проверяет, доступна ли директория для записи.
• Directory::delete($path): статический метод для рекурсивного удаления директории со всем содержимым.

Преимущества D7-подхода:

• Объектный интерфейс: Удобно и читаемо.
• Безопасность: Классы корректно работают с путями и кодировками, принятыми в Битрикс.
• Обработка ошибок: В случае проблем (например, нет прав на запись) методы выбрасывают исключения (\Bitrix\Main\IO\IoException), которые можно поймать в try…catch.
• Унификация: Единый подход к работе с файлами и папками.

Вывод:
Для всей новой разработки, связанной с манипуляциями на файловой системе, настоятельно рекомендуется использовать классы из пространства имен \Bitrix\Main\IO.

Это делает код более надежным, предсказуемым и соответствующим современным стандартам разработки на платформе 1С-Битрикс.

Bitrix D7, \Bitrix\Main\IO\File, Directory, Path, работа с файлами, файловая система D7, putContents, getContents, isDirectory, isFile.