Изображения в Bitrix через API: ресайзы и связь с файлом

Зачем не хранить путь строкой

Идентификатор записи медиафайла в таблице прикладного уровня остаётся стабильным при миграциях между контурами, если перенесли склад /upload/. Прямые строки вида «/upload/company/brand.jpg» труднее пересобирать после CDN и отдельного сервера прикреплённых изображений.

Режим ресайза

Типичный случай виджета: карточка товара 360×260, галерея 1200 с подложкой белого заполнения. Вызов генерации через стандартный хелпер отдаёт кешированную копию и не блокирует витрину повторными конвертациями на каждом хите.

Наборы размеров

Для набора breakpoints хранят пресеты параметров («ширина», «высота», «качество») в одном конфигурируемом массиве и вызывают его из шаблона темы или отдельного сервиса изображений.

Безопасность

Не прокидывайте в ресайз произвольные пути пользователя без проверки: используйте ID из уже проверенного элемента инфоблока.

// Преференция: использовать ID из свойства после отбора активного элемента
$arSize = [
    'width' => 640,
    'height' => 480,
];