README

Установка через composer

Пример composer.json с установкой модуля в local/modules/

{
  "extra": {
    "installer-paths": {
      "local/modules/{$name}/": ["type:bitrix-module"]
    }
  },
  "require": {
    "claramente/claramente.recache": "dev-master"
  }
}

Запустить composer require claramente/claramente.recache dev-master
В административном разделе установить модуль claramente.recache (/bitrix/admin/partner_modules.php?lang=ru)
После установки модуля он будет доступен в разделе Сервисы => Регенерация кэширования (/bitrix/admin/claramente_recache.php?lang=ru)

Модуль регенерации кэша

Данный модуль позволяет автоматически регенерировать кэш на сайте, используя ссылки из карты сайта (sitemap). Это улучшает производительность сайта и обеспечивает актуальность отображаемого контента.

Описание возможностей

Автоматическая регенерация кэша на основе sitemap.
Поддержка нескольких сайтов с индивидуальными настройками.
Мониторинг процесса регенерации с отображением статуса и кода ответа.
Гибкие настройки таймаутов и интервалов для оптимизации нагрузки на сервер.

Настройки модуля

Чтобы настроить модуль, перейдите в раздел:

Сервисы > Генерация кэширования > Настройки модуля

Здесь необходимо выполнить следующие действия:

Убедитесь, что агент установлен:
- Статус: Агент создан: да
Активируйте регенерацию для нужного сайта:
- Поставьте галочку напротив "✅ Включить для сайта".
Добавьте ссылки на sitemap:
- Укажите одну или несколько ссылок на sitemap через запятую.
Убедитесь, что агенты работают на кроне:
- Для работы модуля необходимо чтобы агенты работали на кроне, иначе загрузка страниц будет выполняться с ожиданием на клиенсткой стороне.

Проверка работы модуля

Чтобы проверить работу модуля, выполните следующие действия:

Перейдите в раздел "Страницы регенерации".
Нажмите на кнопку "Регенерировать все страницы".
При успешной регенерации будет отображён соответствующий статус.
В случае ошибки будет указано её описание.

Мониторинг процесса можно выполнять на странице "Страницы регенерации", отслеживая статус и коды ответов.

Страницы регенерации

На странице "Страницы регенерации" отображаются:

Статусы выполнения запросов
Коды ответов от сервера
Обновляемые ссылки

Страницы настроек

На странице "Настройки модуля" представлены параметры конфигурации для каждого сайта.

Описание параметров

✅ Включить для сайта – Активность регенерации для выбранного сайта.
🔗 Ссылки на sitemap – Ссылки на sitemap через запятую, если их несколько.
📅 Последний запуск регенерации – Дата и время последнего запуска регенерации всех ссылок.
🔁 Интервал принудительного автоматического запуска регенерации – Укажите интервал в минутах. Раз в N минут агент будет пересоздавать страницы и загружать их.
🚦 Количество запросов для обработки за цикл – Количество страниц, загружаемых за один цикл (раз в минуту).
⏳️ Таймаут запроса – Максимальное время ожидания ответа от сервера в секундах. Если сервер не ответит в течение этого времени, запрос будет прерван.
💤 Таймаут между запросами – Задержка между запросами в секундах. Полезно для контроля нагрузки на сервер.
👞 Шаг таймаута между запросами – Каждые N запросов будет выполняться дополнительная пауза в N секунд для предотвращения перегрузки.

Советы по использованию

Регулярно проверяйте статус выполнения запросов на странице "Страницы регенерации".
При возникновении ошибок анализируйте коды ответов и сообщения об ошибках.
Оптимизируйте параметры таймаутов и количество запросов для минимизации нагрузки на сервер.

Часто задаваемые вопросы (FAQ)

Вопрос: Что делать, если страницы не регенерируются?

Убедитесь, что Агент создан: да.
Проверьте корректность ссылок на sitemap.
Убедитесь, что включена опция "✅ Включить для сайта".

Вопрос: Почему некоторые страницы не обновляются?

Возможно, указанные ссылки на sitemap ведут на статичные страницы, которые не изменяются.
Проверьте статус и коды ответов на странице "Страницы регенерации".

Заключение

Модуль регенерации кэша – это удобный инструмент для автоматизации обновления кэша на сайте. Благодаря гибким настройкам и возможности мониторинга он позволяет эффективно управлять кэшированием и поддерживать высокую скорость загрузки страниц.

Если у вас возникнут вопросы по настройке или работе модуля, обратитесь в службу поддержки claramente.ru или ознакомьтесь с документацией на странице настроек.

claramente / claramente.recache

Maintainers

Details