Автоматическая настройка водяных знаков в 1С-Битрикс

Настройка автоматического наложения водяных знаков 1С-Битрикс

Представьте: вы импортируете 10 000 товаров через CSV, каждое с 3 изображениями. Итого 30 000 картинок. Без автоматизации пришлось бы вручную накладывать водяной знак на каждую — процесс на неделю. Менеджеры забывают, версии с водяным знаком путаются, лишние копии забивают диск. Нужен перехват на уровне события загрузки файла. Мы, как сертифицированные Bitrix-разработчики с 5+ лет опыта, реализовали уже 50+ проектов по защите изображений. Предлагаем настроить автоматическое наложение под ключ. Свяжитесь с нами — оценим ваш проект и предложим оптимальное решение.

Как работает обработчик OnBeforeFileAdd?

В Битрикс файлы загружаются через CFile::SaveFile() и CFile::Add(). Событие OnBeforeFileAdd позволяет перехватить загрузку до сохранения на диск. Обработчик получает массив $fileFields и идентификатор модуля $moduleId. Пример кода:

AddEventHandler('main', 'OnBeforeFileAdd', function(&$fileFields, $moduleId) { // $moduleId: 'iblock', 'sale', 'catalog' и т.д. if ($moduleId !== 'iblock') { return; // Обрабатываем только изображения каталога } $mimeType = $fileFields['type'] ?? ''; if (!str_starts_with($mimeType, 'image/')) { return; } $tmpFile = $fileFields['tmp_name']; applyWatermarkInPlace($tmpFile); }); 

Функция applyWatermarkInPlace модифицирует временный файл до его сохранения в /upload/. Это означает: в базе и на диске окажется уже обработанный файл, без необходимости хранить оригинал и кеш отдельно. — документация 1С-Битрикс по событиям.

Почему асинхронная обработка выгоднее?

При импорте каталога 5 000 товаров с 3 изображениями каждый — 15 000 операций GD. На среднем сервере обработка одного изображения занимает 50–150 мс. Итого: 12–37 минут добавляется ко времени импорта. Если это неприемлемо — переключаемся на асинхронную схему: сохраняем оригинал, ставим задачу в очередь b_agent, агент обрабатывает батчами по 100 изображений. Асинхронный подход в 3-5 раз уменьшает время импорта — проверено на проектах с каталогами до 100 000 товаров.

Как исключить лишние инфоблоки?

Не все изображения нужно маркировать. Логотип компании в шапке, иконки категорий, системные картинки — всё это проходит через CFile. Фильтрация по $moduleId решает только часть задачи. Для более точного управления добавляем проверку контекста через сессионную переменную:

AddEventHandler('main', 'OnBeforeFileAdd', function(&$fileFields, $moduleId) { if ($moduleId !== 'iblock') return; if (!isset($_SESSION['WATERMARK_ENABLED'])) return; $iblockId = $_SESSION['CURRENT_IBLOCK_ID'] ?? null; $noWatermarkIblocks = \Bitrix\Main\Config\Option::get('catalog', 'no_watermark_iblocks', ''); $excluded = array_map('intval', explode(',', $noWatermarkIblocks)); if ($iblockId && in_array($iblockId, $excluded)) return; applyWatermarkInPlace($fileFields['tmp_name']); }); 

Переменная CURRENT_IBLOCK_ID устанавливается в обработчике события OnBeforeIBlockElementAdd / OnBeforeIBlockElementUpdate. Список исключённых инфоблоков хранится в b_option.

Обработка ошибок: ни одного потерянного файла

Если GD-обработка завершится с ошибкой (битый файл, неподдерживаемый формат), загрузка не должна блокироваться. Обёртка applyWatermarkInPlace в блоке try/catch — при ошибке файл сохраняется без водяного знака, ошибка пишется в лог:

function applyWatermarkInPlace(string $tmpFile): void { try { // Обработка через GD $result = processWatermark($tmpFile); if ($result) { file_put_contents($tmpFile, $result); } } catch (\Throwable $e) { \Bitrix\Main\Diag\Debug::writeToFile( $e->getMessage(), 'watermark_error', '/bitrix/watermark.log' ); // Не прерываем загрузку — файл сохранится оригинальным } } 

2024-01-15 12:00:00 watermarK_erROR: GD library: Image type not supported 2024-01-15 12:00:01 watermarK_erROR: Could not open file /tmp/phpABC123