Инструкция к модулю CDN Beget

Модуль добавляет Beget в стандартные настройки CDN CS-Cart. CDN-ресурс создаётся и настраивается в панели Beget заранее; модуль подключает его домен к магазину, проверяет доступность и передаёт раздачу статических файлов стандартному механизму CDN CS-Cart.

Что делает модуль

• Позволяет выбрать Beget или Amazon CloudFront как текущий CDN-провайдер.
• Подключает Beget по домену уже созданного CDN-ресурса.
• Проверяет обязательные поля для выбранного провайдера перед сохранением.
• Нормализует адрес Beget: удаляет http://, https:// и завершающий /.
• Проверяет доступность Beget по адресу /js/tygh/core.js.
• Записывает выбранный backend в config.local.php и применяет его в текущем запросе без перезапуска магазина.
• Возвращает backend CloudFront, когда модуль отключён или удалён.

Что подготовить перед настройкой

• Создайте CDN-ресурс в панели Beget и получите его домен, например example.begetcdn.cloud.
• Укажите магазин как источник ресурса в Beget и убедитесь, что через CDN открывается файл /js/tygh/core.js.
• Для витрины по HTTPS подготовьте действующий сертификат для CDN-домена.
• Убедитесь, что файл config.local.php существует и доступен веб-серверу для записи.

Создайте ресурс CDN в панели Beget, укажите источник контента магазина и выберите домен для раздачи.

В поле модуля нужен только домен CDN без пути к файлу. Можно вставить адрес с протоколом или без него: при сохранении протокол и завершающий слеш будут удалены.

Где находится модуль

Основная страница настройки: Администрирование → Хранилище → CDN.

Отдельной формы настроек в карточке модуля нет. Выбор провайдера, параметры подключения, статус и управление раздачей файлов находятся на стандартной странице CDN.

Откройте раздел «Хранилище данных» в настройках CS-Cart.

На странице хранилища перейдите на вкладку «Настройки CDN».

Поля и статусы на странице CDN

• Провайдер. Определяет используемый CDN-backend: Beget или Amazon CloudFront.
• CDN URL. Домен существующего ресурса Beget, например example.begetcdn.cloud. Не добавляйте путь к каталогу или файлу.
• Ключ и Секретный ключ. Учётные данные Amazon CloudFront. Эти поля относятся только к CloudFront и для Beget не используются.
• Статус. Для Beget модуль запрашивает /js/tygh/core.js сначала по HTTPS, затем по HTTP. Техническая проверка считает узел доступным, если получен ответ с HTTP-кодом от 200 до 502. Поэтому статус Активен подтверждает доступность узла, но не заменяет проверку реальных файлов на витрине.
• Включить CDN. Передаёт раздачу статических файлов стандартному механизму CDN CS-Cart. Флажок показывается после сохранения CDN-домена и недоступен, пока проверка не вернула активный статус.

Как подключить Beget CDN

1. Завершите настройку ресурса в панели Beget и скопируйте его CDN-домен.
2. Откройте Администрирование → Хранилище → CDN.
3. В поле Провайдер выберите Beget.
4. В поле CDN URL замените прежнее значение доменом Beget. Это особенно важно при переходе с CloudFront, потому что форма использует общие сохранённые CDN-данные.
5. Сохраните изменения. Модуль проверит поле, нормализует домен и выполнит запрос к /js/tygh/core.js.
6. После перезагрузки страницы проверьте статус. Если отображается В процессе, сначала устраните проблему с доменом или источником CDN.
7. Когда статус станет Активен, отметьте Включить CDN и сохраните изменения ещё раз.
8. Проверьте загрузку файлов на витрине по инструкции ниже.

Выберите Beget, укажите CDN URL, дождитесь активного статуса и включите CDN.

Если изменить только поле Провайдер и не редактировать параметры, модуль переключит backend с уже сохранёнными CDN-данными. При первой настройке провайдера обязательно заполните относящиеся к нему поля перед сохранением.

Как переключиться на CloudFront

1. На странице CDN выберите Amazon CloudFront.
2. Если CloudFront настраивается впервые или его данные изменились, заполните поля Ключ и Секретный ключ.
3. Сохраните изменения и дождитесь результата стандартной настройки CloudFront в CS-Cart.
4. Если backend активен, при необходимости отметьте Включить CDN и снова сохраните изменения.

При смене провайдера модуль вызывает стандартную операцию отключения текущего CDN-backend, а затем применяет новый. Для Beget внешняя команда отключения не отправляется: ресурс в панели Beget продолжает существовать. При переходе с CloudFront проверьте состояние его distribution после переключения.

Выбранный провайдер сохраняется в config.local.php. Если файл недоступен для записи, CS-Cart покажет ошибку; исправьте права и повторите сохранение.

Что происходит при отключении модуля

В конфигурации CS-Cart текущим backend снова становится CloudFront. Модуль не обращается к API Beget и не выключает или удаляет CDN-ресурс во внешней панели — при необходимости сделайте это отдельно в аккаунте Beget.

Как проверить работу

1. На странице CDN убедитесь, что выбран Beget, статус имеет значение Активен, а флажок Включить CDN отмечен.
2. Откройте https://ваш-cdn-домен/js/tygh/core.js и убедитесь, что сервер возвращает сам JavaScript-файл без перенаправления на ошибку или служебную страницу.
3. Откройте витрину и инструменты разработчика браузера, затем перейдите на вкладку Network.
4. Обновите страницу и проверьте адреса изображений, CSS и JavaScript: запросы должны уходить на домен Beget.
5. Проверьте несколько страниц витрины и убедитесь, что для CDN-запросов нет ошибок 4xx/5xx и предупреждений о смешанном HTTP/HTTPS-контенте.
6. Очистите кэш CS-Cart и браузера и повторите проверку, если в HTML остались прежние адреса ресурсов.
7. Для технической проверки откройте config.local.php: при выбранном Beget должна присутствовать строка $config['cdn_backend'] = 'beget';.

Если CDN не работает

• Статус остаётся «В процессе». Проверьте DNS CDN-домена, сертификат, настройки источника в Beget и прямой ответ по адресу /js/tygh/core.js. Модуль пробует HTTPS, а затем HTTP.
• Флажок «Включить CDN» недоступен. Сначала добейтесь активного статуса: интерфейс блокирует флажок, пока проверка домена не пройдена.
• Провайдер не сохраняется. Проверьте существование и права на запись для config.local.php, затем повторите сохранение.
• Появилось сообщение об обязательных полях. Для Beget нужен CDN URL; для CloudFront нужны оба поля — Ключ и Секретный ключ.
• Статус активен, но файлы загружаются с домена магазина. Проверьте флажок Включить CDN, сохраните форму и очистите кэш CS-Cart и браузера.
• Файлы через CDN возвращают ошибку или неверное содержимое. Проверьте источник, правила путей и HTTPS-настройки ресурса в панели Beget. Активный статус сам по себе не подтверждает корректную выдачу всех файлов.
• После переключения ресурс остался в Beget. Это ожидаемое поведение: модуль не управляет внешним ресурсом через API Beget.