Файлы PHP в Bitrix: все аспекты работы с файловой системой

Ниже приведены расширенные примеры с подробными комментариями.

Пример 1. Загрузка файла с одновременным созданием миниатюры

// Загрузка, сохранение, ресайз и удаление оригинала (опционально)
function uploadAndThumbnail($fileArray, $thumbWidth = 150, $thumbHeight = 150) {
    $fileId = CFile::SaveFile($fileArray, 'products');
    if (!$fileId) return false;

    $thumb = CFile::ResizeImageGet($fileId, ['width' => $thumbWidth, 'height' => $thumbHeight], BX_RESIZE_IMAGE_EXACT);
    // Возвращаем массив с ID оригинала и путём к превью
    return [
        'ORIGINAL_ID' => $fileId,
        'THUMB_SRC'   => $thumb['src'],
    ];
}

// Использование
$result = uploadAndThumbnail([
    'name' => 'photo.jpg',
    'size' => 1024000,
    'tmp_name' => $_FILES['photo']['tmp_name'],
    'type' => 'image/jpeg',
    'MODULE_ID' => 'iblock',
], 200, 200);
if ($result) {
    echo 'Оригинал ID: ' . $result['ORIGINAL_ID'] . ', миниатюра: ' . $result['THUMB_SRC'];
} else {
    echo 'Ошибка';
}

Оригинал ID: 456, миниатюра: /upload/resize_cache/iblock/abc/200_200_1/photo.jpg

Пример 2. Получение всех файлов, прикреплённых к элементу инфоблока

$elementId = 123;
$iblockId = 5;
$propertyCode = 'FILES'; // множественное свойство типа «Файл»
$files = CIBlockElement::GetProperty($iblockId, $elementId, [], ['CODE' => $propertyCode]);
while ($file = $files->Fetch()) {
    if ($file['VALUE'] > 0) {
        $arFile = CFile::GetByID($file['VALUE'])->Fetch();
        echo 'Файл: ' . $arFile['ORIGINAL_NAME'] . ' (' . $arFile['FILE_SIZE'] . ' байт)
';
        echo 'Путь: ' . CFile::GetPath($file['VALUE']) . '
';
    }
}

Файл: report.pdf (204800 байт)
Путь: /upload/iblock/abc/report.pdf
Файл: image.png (512000 байт)
Путь: /upload/iblock/def/image.png

Пример 3. Загрузка файла через асинхронный запрос (AJAX)

// front-end (JavaScript)
const formData = new FormData();
formData.append('file', fileInput.files[0]);
fetch('/ajax/upload.php', {
    method: 'POST',
    body: formData
}).then(res => res.json()).then(data => console.log(data));

// back-end (ajax/upload.php)
require_once $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';
if ($_SERVER['REQUEST_METHOD'] === 'POST' && !empty($_FILES['file'])) {
    $fid = CFile::SaveFile($_FILES['file'], 'ajax');
    if ($fid) {
        echo json_encode(['status' => 'ok', 'fileId' => $fid]);
    } else {
        echo json_encode(['status' => 'error']);
    }
}

Пример 4. Работа с временными файлами (CFile::MakeFileArray)

// Создать файл из строки и временно сохранить
$tempFile = CFile::MakeFileArray([
    'content' => 'Hello, world!',
    'filename' => 'hello.txt'
]);
$fid = CFile::SaveFile($tempFile, 'temp');
// $tempFile содержит путь и tmp_name, но после сохранения можно удалить
unlink($tempFile['tmp_name']);

Файл сохранён как временный, ID: 789

Пример 5. Обработка ошибок при загрузке через агент

// Агент для пакетной загрузки файлов из внешнего источника
function agentBatchUpload() {
    $urls = ['https://example.com/1.jpg', 'https://example.com/2.jpg'];
    foreach ($urls as $url) {
        $temp = CFile::MakeFileArray($url);
        if ($temp === false) {
            AddMessage2Log('Не удалось загрузить: ' . $url, 'upload_agent');
            continue;
        }
        CFile::SaveFile($temp, 'external');
    }
    return 'agentBatchUpload();';
}

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

Пример 6. Изменение прав доступа к файлу через API

$fileId = 100;
$arFile = CFile::GetByID($fileId)->Fetch();
$filePath = $_SERVER['DOCUMENT_ROOT'] . $arFile['SUBDIR'] . '/' . $arFile['FILE_NAME'];
chmod($filePath, 0644); // или 0444 для только чтения

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