Документация для разработчиков
Темная тема

File

Описание и методы

File - класс для работы с файлами.

Метод Описание С версии
close Метод закрывает файл 15.0.15
getSize Метод возвращает размер файла. 14.5.1
open Метод открывает файл и возвращает указатель файла.
seek Метод ищет указатель файла от начала 15.0.15
deleteFile Метод удаляет файл
getFileContents Метод возвращает содержимое файла в виде одной строки.
isFileExists Метод определяет существует ли файл.
putFileContents Метод записывает данные в файл. 15.0.15

Пример

$file = new IO\File(Application::getDocumentRoot() . "/file.txt");

Информация о файле:

$isExist = $file->isExists(); // true, если файл существует

$dir = $file->getDirectory(); // Директория файла в виде объекта IO\Directory
$dir = $file->getDirectoryName(); // Директория файла

$fileName = $file->getName(); // Имя файла
$fileExt = $file->getExtension(); // Расширение файла
$fileSize = $file->getSize(); // Размер файла в байтах
$contentType = $file->getContentType(); // Content-type

$createdAt = $file->getCreationTime(); // Дата создания, timestamp
$accessAt = $file->getLastAccessTime(); // Дата последнего доступа, timestamp
$modifiedAt = $file->getModificationTime(); // Дата модификации, timestamp

$perms = $file->getPermissions(); // Права на файл в виде десятичного числа
$perms = substr(sprintf('%o', $file->getPermissions()), -3); // Права на файл в виде восьмеричного числа

Действия над файлами:

$content = $file->getContents(); // Получить содержание файла
$file->putContents("data"); // Записать содержимое в файл с заменой
$file->putContents("data", IO\File::APPEND); // Дописать содержимое в конец файла
$file->readFile(); // Вывести содержимое файла

$file->rename(Application::getDocumentRoot() . "/new_file.txt"); // Переместить/переименовать файл
$file->delete(); // Удалить файл

У некоторых методов есть статические варианты:

$path = Application::getDocumentRoot() . "/another_file.txt";
IO\File::isFileExists($path); // Проверить существование файла

IO\File::getFileContents($path); // Получить содержание файла
IO\File::putFileContents($path, "data"); // Записать содержимое в файл с заменой
IO\File::putFileContents($path, "data", self::APPEND); // Дописать содержимое в конец файла

IO\File::deleteFile($path); // Удалить файл


© «Битрикс», 2001-2024, «1С-Битрикс», 2024