Работа с файлами в CMS Bitrix на PHP: практические решения

Расширенные примеры работы с файлами в Bitrix

Пример 1: Пакетная загрузка нескольких файлов из формы в одно свойство типа «Набор файлов».

// В форме: <input type="file" name="FILES[]" multiple>
$files = $_FILES['FILES'];
$fileIds = [];
if (is_array($files['tmp_name'])) {
    foreach ($files['tmp_name'] as $index => $tmpName) {
        if ($files['error'][$index] === UPLOAD_ERR_OK) {
            $arFile = [
                'name' => $files['name'][$index],
                'size' => $files['size'][$index],
                'tmp_name' => $tmpName,
                'type' => $files['type'][$index]
            ];
            $fileId = CFile::SaveFile($arFile, 'iblock');
            if ($fileId) $fileIds[] = $fileId;
        }
    }
}
if (!empty($fileIds)) {
    $el = new CIBlockElement;
    $arFields = [
        'IBLOCK_ID' => 3,
        'NAME' => 'Несколько файлов',
        'PROPERTY_VALUES' => ['MULTI_FILE' => $fileIds]
    ];
    $el->Add($arFields);
}

Результат: элемент инфоблока с прикреплёнными файлами. В базе свойство типа «Набор файлов» хранит сериализованный массив ID.

// В админке файлы отображаются как список ссылок

Пример 2: Создание файла на лету и его регистрация в системе без физической загрузки.

$content = 'Содержимое динамического файла';
$tmpPath = tempnam(sys_get_temp_dir(), 'bx');
file_put_contents($tmpPath, $content);
$arFile = CFile::MakeFileArray($tmpPath);
$arFile['name'] = 'generated.txt';
unlink($tmpPath); // удаляем исходный временный файл
if ($arFile) {
    $fileId = CFile::SaveFile($arFile, 'main');
    if ($fileId) {
        echo 'ID созданного файла: ' . $fileId;
        // Далее можно прикрепить к элементу или скачать
    }
}

ID созданного файла: 789

Пример 3: Изменение файла (замена) через обновление элемента инфоблока.

$elementId = 456;
$el = new CIBlockElement;
$arFields = [
    'PROPERTY_VALUES' => [
        'FILE' => [
            'VALUE' => CFile::SaveFile(
                $_FILES['NEW_FILE'],
                'iblock',
                false,
                false,
                true // перезапись существующего файла?
            ),
            'OLD_VALUE' => $oldFileId // передаём старый ID для удаления
        ]
    ]
];
$el->Update($elementId, $arFields);

Это пример из документации Bitrix: свойство типа «Файл» при передаче массива с ключами VALUE и OLD_VALUE автоматически удаляет старый файл при успешном сохранении нового.

Пример 4: Чтение файла через CFile::GetContents (если доступен) или вручную.

$fileId = 100;
$arFile = CFile::GetFileArray($fileId);
if ($arFile) {
    $fullPath = $_SERVER['DOCUMENT_ROOT'] . $arFile['SRC'];
    if (file_exists($fullPath)) {
        $handle = fopen($fullPath, 'r');
        while (!feof($handle)) {
            $line = fgets($handle);
            echo htmlspecialchars($line) . '<br>';
        }
        fclose($handle);
    }
}

Вывод: построчное отображение текстового файла в браузере.

Пример 5: Получение размера и MIME-типа без загрузки файла.

$fileId = 101;
$arFile = CFile::GetFileArray($fileId);
if ($arFile) {
    echo 'Размер: ' . CFile::FormatSize($arFile['FILE_SIZE']);
    echo 'Тип: ' . $arFile['CONTENT_TYPE'];
    echo 'Дата: ' . $arFile['TIMESTAMP_X'];
}

Размер: 1.2 Мб
Тип: application/pdf
Дата: 2025-04-01 12:34:56

Пример 6: Удаление файла по ID с проверкой существования записи.

$fileId = 999;
$dbFile = CFile::GetByID($fileId);
if ($dbFile->Fetch()) {
    CFile::Delete($fileId);
    echo 'Файл удалён';
} else {
    echo 'Файл с таким ID не найден';
}

Пример 7: Работа с временными файлами Bitrix (система временных меток).

$tempFileId = CFile::SaveFile($_FILES['TEMP'], 'main', false, true);
// третий параметр 'subdir' - можно передать false для корня upload/tmp
// четвёртый 'tmp' - true означает временное хранилище
if ($tempFileId) {
    sleep(3600);
    // При следующем запуске агента файл может быть очищен
}

Система временных файлов автоматически удаляет файлы старше определённого периода (настраивается в главном модуле).