LESS компилятор (EcomLabs)

Что умеет решение

Модуль компиляции LESS предназначен для фронтенд-разработчиков, использующих лаконичный синтаксис с общими переменными и вложенной иерархией классов. Примеры кода демонстрируют определение цветовых переменных и стилизацию элементов с поддержкой медиа-запросов для адаптивной верстки.

Обработчик модуля подписан на системное событие main/OnProlog, которое регистрируется при установке через RegisterModuleDependences. Это обеспечивает автоматическое выполнение обработки на каждом запросе без необходимости ручного подключения файлов.

При активном модуле система сканирует файловую структуру сайта для сбора всех файлов с расширением .less. По умолчанию исключаются каталоги bitrix/, upload/, vendor/, node_modules/ и .git/, однако список исключений может быть настроен в административной панели.

Модуль компилирует файлы LESS согласно ручному списку. Для отслеживания изменений вычисляется отпечаток состояния каждого файла, включающий путь, время последнего изменения и размер. Если отпечаток совпадает с сохранённым и скомпилированный файл style.css уже существует, пересборка не запускается, а страница получает ссылку на готовый ресурс. При изменении отпечатка (добавление, удаление или редактирование файла) файлы компилируются заново через Less_Parser, а результат атомарно заменяет старый style.css. Итоговый файл сохраняется в каталоге /upload/ecl_lesscompiler/SITE_ID/style.css, где SITE_ID — уникальный идентификатор сайта. Подключение осуществляется в секции head отдельным тегом link через метод $APPLICATION->SetAdditionalCSS(), независимо от остальных CSS-тем сайта. В режиме композитного сайта обработчик обращается только к файловой системе и добавляет ссылку на статический файл. При генерации композитного снимка страницы этот тег link попадает в закешированный HTML, а браузер затем запрашивает сам файл style.css напрямую, минуя PHP. Механизм композитного кэширования не нарушается. Скан директории в режиме «все файлы» дополнительно кэшируется на 60 минут через Bitrix\Main\Data\Cache, чтобы избежать обхода дерева каталогов при каждом запросе. Кнопка «Принудительно пересобрать сейчас» в настройках сбрасывает этот кэш и инициирует немедленную пересборку CSS.

При возникновении ошибок компиляции LESS, включая синтаксические ошибки или отсутствие директивы @import, система фиксирует их в журнале событий Bitrix. Это предотвращает падение страницы. Если ранее был успешно собран рабочий файл style.css, система отдаёт его пользователю.

«LESS компилятор (EcomLabs)» можно подключить с помощью General iT: установить модуль, настроить его и убедиться, что интеграция работает корректно.