6. Ежедневная работа

Главное правило свежести

Закешированная страница остаётся такой, какой она была в момент сохранения, пока её не очистят. Очищаться она может:

автоматически, когда плагин «заметил» событие магазина (см. ниже);
вручную: весь кеш или одна страница;
по лимиту размера (⭐ Premium) или по сроку годности (TTL, только Metadata v2 с cron).

Поэтому ключевой вопрос: какие изменения плагин замечает сам, а какие нет. Ниже ответ.

Что очищается само

Для классического файлового кеша (по умолчанию) плагин реагирует на такие события Shop-Script:

Событие	Что очищается	Настройка
Сохранили товар в админке	Страницы этого товара и его категорий	«Удаление кеша после редактирования товара» (включено)
Удалили товар	Страницы этого товара и списки, где он был	Всегда, независимо от настройки
Покупатель оставил отзыв	Только страница этого товара (основной адрес, адрес через категорию, страница отзывов; на каждой витрине и для каждого устройства). Списки категорий и главная показывают новый рейтинг, когда будут пересобраны	«Удаление кешированных страниц после добавления комментария» (включено)
Оформлен заказ	Страницы заказанных товаров и их категорий	«Удаление кешированных страниц после оформления заказа» (выключено; может нагружать базу на большом каталоге). При Metadata v2 страницы заказанных товаров очищаются при оформлении заказа независимо от этой настройки
Плагин «Адаптивные изображения PRO» пересчитал картинки товара (событие `responsiveimages_derivatives_updated`, 3.4.2)	Страницы только этих товаров. Каталог целиком, главная, поиск не очищаются: они покажут новые картинки после собственной пересборки. Подтверждено только на неопубликованной версии Images PRO: ⚠️ с реальными релизами Images PRO не проверялось	Работает сама, без настройки

При включённом Metadata v2 набор событий шире: изменения категорий, подборок, тегов, значков, валют, акций, характеристик, смена остатков. Эти страницы помечаются «тегами», и очищаются только те, где данные встречаются.

Чего плагин не видит. Данные, изменённые в обход Shop-Script: прямые SQL-запросы, часть импортов (например, массовое обновление цен и остатков), внешние интеграции, ручные правки базы. Для классического кеша не отслеживаются также правки категорий, валют и акций. После такого изменения очистите кеш вручную: весь или нужные страницы. Это не дефект, а граница автоматической очистки; плагин ничего не обещает сверх неё.

⚠️ Список событий взят из обработчиков плагина (lib/config/plugin.php). Реакция на каждое событие в реальном магазине не проверялась.

Рекомендация. После массового импорта цен или остатков, смены темы, правки шаблонов, изменения налогов и доставки, которые видны на страницах, один раз выполните полную очистку.

Очистить весь кеш

Вкладка «Основные» → отметьте «Очистить кеш» → «Сохранить».
Под галочкой написано, что удалится: «Весь кеш будет удалён при сохранении» (по умолчанию) или список типов страниц, если вы выбрали «Частично удалить кеш» (⭐ Premium).
Следующий посетитель каждой страницы получит MISS; страницы пересоберутся по мере посещений. На оживлённом магазине сразу после очистки возможен краткий рост нагрузки на PHP.

С Metadata v2 полная очистка укладывается в ограниченное время (около 10 секунд на записи в базе): страницы перестают отдаваться сразу, а оставшиеся служебные записи, если их очень много, удаляет в фоне cron-задание (на странице тогда написано «N старых записей удаляются в фоне»).

Очистить одну страницу

Блок «Очистить одну страницу» (все редакции). Нужен, когда вы поправили одну страницу и не хотите сбрасывать весь кеш.

Введите полный адрес с доменом, например https://shop.example/catalog/item/. Одного пути недостаточно: при нескольких витринах домен указывает, какая страница имеется в виду.
Нажмите «Проверить страницу». Ничего не удаляется: плагин только отвечает, есть ли копия («Копия этой страницы есть в кеше»), сколько вариантов по устройствам проверено и сколько копий найдено.
Нажмите появившуюся красную кнопку «Очистить эту страницу» и подтвердите. Результат: «Страница очищена. Сохранённая копия страницы удалена. Следующий визит построит её заново».

Проверка и результат (снимки 3.4.3):

Что нужно знать:

Параметры после «?» и фрагмент после «#» игнорируются: плагин напомнит об этом.
Удаляются оба файла копии (обычный и .gz) для всех устройств стратегии.
Не очищаются: другие страницы с тем же содержимым (список категории, главная, «похожие товары»), копия в CDN и в браузере посетителя.
Если страница строилась ровно в этот момент, она может сохраниться снова со старым содержимым. Повторите действие через несколько секунд.
Страницы, которые никогда не кешируются (оформление, личный кабинет, вход, заказы), и служебные адреса отклоняются.
Для администратора с доступом к командной строке есть аналог: php cli.php shop SupercachePluginPurgeUrl --url https://shop.example/page/ (с ключом --dry-run 1 только проверяет). 🔧

Cron: обслуживание по расписанию

Cron — планировщик заданий сервера. Плагину нужно одно задание, и какое, зависит от движка. Точную строку для вашего сайта показывает блок «Обслуживание (cron)» на странице настроек (с путём к вашему сайту). Её нужно добавить в планировщик хостинга. 🔧

Движок	Команда	Как часто	Что даёт	Что будет без неё
Классический кеш	`php cli.php shop SupercachePluginStorage`	раз в 10 минут	Замер места на диске; основа резерва свободного места и ограничения размера (⭐ Premium)	Кеш продолжает работать; цифры диска устаревают, лимит размера не применяется
Metadata v2	`php cli.php shop SupercachePluginSweep`	раз в 5 минут	Обслуживание реестра: сроки годности (TTL), доудаление записей, порции замера, лимит	Страницы не истекают по TTL, остаётся хвост записей после больших очисток

Типичный вид строки в планировщике (подставьте путь вашего сайта; его же покажет блок):

*/10 * * * * /usr/bin/php -q /путь/к/сайту/cli.php shop SupercachePluginStorage

Блок «Обслуживание (cron)» показывает команду, «Последнее состояние» (до первого запуска «Ни разу не выполнялся», после — например, «Актуален (меньше минуты назад)») и что будет без задания. Если состояние не меняется, задание не запускается или не может записать результат.

Снимки 3.4.3: до и после первого запуска команды.

Хостинг-подсказки: ссылки «Настройка задания Cron в облаке Webasyst» и «Настройка Cron для Webasyst на другом хостинге» есть на странице настроек. Задание должно выполняться от того же пользователя, от которого работает сайт, иначе файлы, созданные другим пользователем, могут оказаться недоступны для записи веб-серверу.

Ошибка, которую легко сделать: CacheDel в cron

Отдельный блок «Необязательно: полная очистка кеша по расписанию (CRON)» показывает команду SupercachePluginCacheDel. Она очищает ВЕСЬ кеш при каждом запуске и обслуживанием не является: для лимита и цифр диска она не нужна. Если вы ставили её раньше «для лимита», замените на SupercachePluginStorage (или SupercachePluginSweep при Metadata v2). Используйте CacheDel, только если вам нужна именно регулярная полная очистка, например раз в сутки.

Диск и размер кеша

Посмотреть: блок «Состояние SuperCache» (страницы кеша, все данные плагина, временные файлы, корзина, свободное место). Если значения устарели, нажмите «Измерить диск сейчас».
Резерв свободного места (все редакции, по умолчанию 50 МБ): пока свободного места меньше, новые страницы не пишутся, магазин работает как обычно.
Ограничение размера (⭐ Premium) и действие при достижении: см. главу 3. Работает только при работающем cron.
Если диск уже заполнен: глава 10.

Просмотр сайта без кеша

Чтобы увидеть витрину так, как её видит PHP, без кеша: включите «Обход кеша для администратора» (глава 3) или откройте страницу в браузере, где вы вошли в админку: для вошедших пользователей кеш не используется при включённой настройке «Не кешировать авторизованных пользователей».

После изменения настроек плагина

Что изменили	Нужна ли очистка кеша	Нужны ли новые правила сервера
Стратегия, локализация, query string, gzip	Да	Да (при «Через сервер»)
Роботы, профиль правил, диагностический заголовок, обход для администратора, «Адаптивные изображения PRO»	Для «Адаптивные изображения PRO» — да, один раз	Да (при «Через сервер»)
Динамические блоки, условный рендеринг, анимация, «Отключать кеш при обновлении страницы», HTML-минификация	Да	Нет
Исключения по URL	Желательно (чтобы удалить уже сохранённое)	Нет