SDWSKi Cache. Плагин кеширования для WordPress

Задача

Стандартные кэш-плагины хорошо работают на блогах и плохо на магазинах. Типичные проблемы, которые я хотел закрыть:

• в кэш попадает страница с чужим счётчиком корзины;
• в карточке товара остаётся старый остаток;
• многоязычный сайт отдаёт посетителю страницу не на его языке;
• при сбое оптимизации (минификация, объединение файлов) пользователь видит пустой экран;
• в админке полно рекламы и ссылок на сторонний сайт.

Архитектура

Плагин состоит из трёх уровней, каждый из которых решает свою часть задачи.

1. Загрузчик (sdwski-cache.php). Решает только одно: можно ли запускать движок. Если на сайте уже активен оригинальный плагин или другая копия, загрузчик ничего не подключает, не регистрирует хуки и показывает уведомление с кнопкой «Отключить и запустить». Все классы, функции и константы движка имеют собственные префиксы, поэтому ошибки вида «Cannot redeclare» исключены, в каком бы порядке WordPress ни загрузил плагины.

2. Движок (sdwski-engine.php, inc/). Классический слой: генерация и очистка кэша, минификация и объединение CSS/JS, предзагрузка, правила исключений, CDN (в том числе Cloudflare), очистка Varnish, модуль безопасности, планировщик очистки, WP-CLI. Здесь же перехватывается вывод страницы через output buffer.

3. Turbo-слой (inc/turbo/). Мой основной вклад. Это drop-in advanced-cache.php, который WordPress подключает раньше темы и плагинов, и ядро turbo-core.php, которое управляет его настройками, статусом и очисткой.

Как работает отдача из drop-in

Порядок проверок в advanced-cache.php выстроен так, чтобы при любом сомнении отдать запрос WordPress:

1. Обрабатываются только запросы GET.
2. Запросы бота предзагрузки всегда уходят в WordPress, чтобы страница была создана или обновлена.
3. Хост и схема (http/https) должны совпадать с адресом сайта, что покрывает варианты с www и без него.
4. Если в cookie есть признаки вошедшего пользователя, комментатора, защищённой паролем записи или сессии магазина, посетитель получает живую страницу. Список можно расширить своими именами cookie.
5. Только после этого ищется готовый файл в кэше.

Если файл найден, ответ собирается без запуска WordPress. В заголовках отдаются Vary: Accept-Encoding, ETag и X-ruzi-Turbo: HIT, который удобно проверять в браузере или через curl -I.

Предсжатые копии и условные запросы

Сжатие выполняется один раз при создании страницы, а не при каждом запросе. Рядом с index.html лежат index.html.gz и, если на сервере есть расширение brotli, index.html.br. Drop-in смотрит на заголовок Accept-Encoding и отдаёт подходящий вариант. На условный запрос с совпавшим ETag отвечает 304 без чтения файла.

При очистке кэша удаляются все варианты страницы: обычный, gzip и brotli, а также постраничная навигация и копии по языкам. Это защищает от «осиротевших» сжатых файлов, которые иначе пережили бы удалённую страницу.

Режим интернет-магазина (WooCommerce)

Самая объёмная часть работы. Правила дублируются на трёх уровнях: в .htaccess, в drop-in и в движке, поэтому защита не зависит от одного переключателя.

Все настройки магазина вынесены на отдельную вкладку «WooCommerce». Классы элементов можно вводить без точки, например cart-count.

Многоязычность

Кэш ведётся отдельно по каждому языку, поэтому посетитель с английской версией не получит кэш русской и наоборот. Плагин SDWSKi Cache совместим с плагинами мультиязычности. В первую очередь 100% гарантирована совместимость с плагином ИИ-перевода SDWSKi Translate.

Отказоустойчивость

• Откат при сбое оптимизации. Callback output buffer защищён: если минификация или объединение файлов завершились ошибкой, отдаётся исходная страница.
• Drop-in можно удалить в любой момент. Тогда WordPress просто продолжает работать как обычно, это сказано в самом заголовке файла.
• Статус-страница Turbo показывает по пунктам, всё ли настроено: drop-in, права, .htaccess, доступность brotli.
• Безопасное удаление. Плагин не удаляет общие данные, пока на сайте остаётся другая копия движка.

Что ещё есть внутри

Предзагрузка кэша по расписанию через WP-Cron, минификация HTML/CSS/JS, объединение файлов, отложенная загрузка изображений, правила исключений, очистка кэша конкретных страниц, настройки для Nginx и Varnish, интеграции с CDN, браузерное кэширование, отключение emoji, WP-CLI. Интерфейс и подробная вкладка «Инструкция» переведены на русский.

Стек

PHP, WordPress Plugin API (хуки, WP-Cron, output buffering, drop-in advanced-cache.php), правила Apache .htaccess, JavaScript и CSS для админ-интерфейса и «живых» элементов магазина, gettext (.pot, .po, .mo) для локализации.

Установка

1. Скопируйте папку sdwski-cache в /wp-content/plugins/ и активируйте плагин.
2. В меню «SDWSKi Cache» включите «Cache System» и сохраните.
3. Откройте «Настройки → SDWSKi Cache: Turbo» и убедитесь, что все пункты статуса зелёные.
4. Проверьте результат: откройте страницу в приватном окне и найдите заголовок X-ruzi-Turbo: HIT.

История версий

• 1.5.3-turbo.10 — отдельная вкладка WooCommerce, «живой» остаток, «живая» мини-корзина.
• 1.5.3-turbo.9 — защита корзины и остатков теперь всегда включена при активном WooCommerce, очистка кэша при любых изменениях товара и заказа, максимальный возраст кэша 3 часа.
• 1.5.3-turbo.8 — счётчик корзины подставляется скриптом, исправлено сохранение настроек режима магазина.
• 1.5.3-turbo.2 — защита от конфликта с оригинальным плагином, собственная папка, вкладка «Инструкция».
• 1.5.3-turbo.1 — режим магазина, drop-in, предсжатые страницы, ETag и 304, новый интерфейс, удалена реклама.

Лицензия и происхождение

Проект распространяется по GPLv2 или новее. Он основан на открытом GPL-плагине страничного кэша: исходный код принадлежит его авторам, а мои изменения и дополнения оформлены отдельно и описаны выше.