Функция получения URL файла с версией в Битрикс

Рассмотрим следующий кейс: на сайте обновились css/js скрипты. Мы то с вами знаем, что для загрузки страницы со свежими css/js, нужно обновить её через сброс кеша. Что же делать простому пользователю? Он ведь не знает, как это сделать.

Здесь нам на помощь приходит следующий трюк: необходимо указать через знак вопроса версию файла.

Например вот так:

<link rel="stylesheet" 
      href="main.css?1671194992597763"
>

Оказывается, в Битрикс есть специальная функция, которая возвращает url файла с указанием метки версии файла на основе даты изменения и размера файла. Таким образом версия файла будет постоянной, если сам файл не редактировался.

Сама функция вызывается вот так:

<link href="<?= \CUtil::GetAdditionalFileURL('some.css');?>" 
      rel="stylesheet"
>

Для js поступаем аналогично:

<script src="<?= \CUtil::GetAdditionalFileURL('vendor.js') ?>">
</script>