Модуль Redis cache для OkayCMS

Модуль додає Redis-кеш для частини запитів у магазині, щоб сторінки і блоки відкривалися швидше та створювали менше навантаження на сервер.

Можливості

Кешування даних магазину

Модуль кешує популярні дані, які часто запитуються на фронтенді, зокрема:

• списки товарів;
• частини даних товару (варіанти, зображення, характеристики);
• фільтри каталогу;
• бренди, автори, блог;
• валюти.

Гнучкі TTL (час життя кешу)

• Можна окремо налаштувати TTL для кожного блоку в адмінці.
• Якщо не вказувати окреме значення, використовується TTL за замовчуванням.

Керування кешем в адмінці

• Увімкнення/вимкнення Redis-кешу.
• Перевірка підключення до Redis кнопкою «Протестувати підключення».
• Перегляд базової статистики (кількість ключів, використана пам’ять).
• Очищення кешу поточної Redis DB кнопкою «Очистити весь кеш Redis».

Безпека кешу (опційно)

• Є поле «Секрет підпису кешу (HMAC)».
• Якщо задати секрет, модуль перевіряє цілісність кеш-даних перед читанням.

Вимоги

• OkayCMS v4.5.2
• Встановлений PHP-розширення redis (phpredis)
• Запущений Redis сервер (локально або на окремому сервері)

Встановлення

Варіант 1: Скачування з GitHub

1. Скачайте останню версію модуля з останнього релізу на GitHub.
2. Розпакуйте архів на сервері в каталог: {OkayCMS_root}/Okay/Modules/

Варіант 2: Встановлення через Git

1. Виконайте команду в директорії {OkayCMS_root}/Okay/Modules/Sviat:

   git clone https://github.com/devSviat/Redis-OkayCMS.git Redis

Результат встановлення

Шлях до модуля має бути таким:

{OkayCMS_root}/Okay/Modules/Sviat/Redis/

Після встановлення перейдіть в адмін-панель → Модулі → Знайдіть «Redis cache» → Натисніть «Встановити».

Налаштування

1. Перейдіть в адмін-панель → Модулі → Redis cache.
2. Увімкніть перемикач «Увімкнути Redis кеш».
3. Заповніть підключення:
   • Host
   • Port
   • DB
   • Username (якщо використовуєте ACL)
   • Password (якщо потрібна авторизація)
4. За потреби вкажіть:
   • префікс ключів;
   • TTL за замовчуванням;
   • HMAC-секрет (необов’язково).
5. Натисніть «Протестувати підключення».
6. Якщо все добре — натисніть «Зберегти».
7. За потреби налаштуйте TTL для окремих хелперів у нижньому блоці.

Важливо

• Кеш працює тільки на фронтенді; адмін-запити не кешуються.
• Очищення кешу в модулі очищає всю поточну Redis DB (а не лише ключі одного блоку).
• Якщо змінюєте HMAC-секрет, старі ключі краще оновити/очистити.
• Якщо Redis недоступний, сайт продовжить працювати без кешу.

Ліцензія

Модуль розповсюджується за вільною ліцензією MIT