Как избежать проблем с кешированием WooCommerce при использовании Varnish

Диагностика проблемы: почему WooCommerce не работает корректно с Varnish

После настройки Varnish в качестве HTTP-ускорителя для WordPress с WooCommerce часто возникают проблемы: не обновляется корзина, не отображаются актуальные данные о товарах и заказах, пользователи видят устаревшие страницы. Это связано с тем, что Varnish кеширует HTML-страницы, а WooCommerce требует динамического обновления содержимого для каждого пользователя.

Проверка симптомов

• Корзина не обновляется после добавления товара.
• В личном кабинете отображаются старые данные.
• Произвольные страницы WooCommerce не меняются сразу после изменений.

Для диагностики можно посмотреть HTTP-заголовки ответа через браузер или curl. Если в ответе есть заголовок X-Varnish и страница кешируется слишком долго, значит Varnish не настроен должным образом для WooCommerce.

Пошаговое решение: настройка Varnish для правильной работы с WooCommerce

Главная задача — исключить кеширование динамических страниц WooCommerce и API-запросов, при этом кешировать статичные ресурсы и страницы.

1. Добавьте исключения в конфигурацию Varnish (VCL)

Откройте VCL-конфигурационный файл (обычно /etc/varnish/default.vcl) и внесите следующие правки:

sub vcl_recv {
    # Отключаем кеширование для административной части
    if (req.url ~ "^/wp-admin" || req.url ~ "^/wp-login.php") {
        return (pass);
    }

    # Не кешируем страницы корзины, оформления заказа и личного кабинета WooCommerce
    if (req.url ~ "^/cart" || req.url ~ "^/checkout" || req.url ~ "^/my-account") {
        return (pass);
    }

    # Не кешируем AJAX-запросы WooCommerce
    if (req.http.X-Requested-With == "XMLHttpRequest") {
        return (pass);
    }

    # Не кешируем запросы с куками, которые WooCommerce использует для сессий
    if (req.http.Cookie ~ "woocommerce_items_in_cart" || req.http.Cookie ~ "wp_woocommerce_session_") {
        return (pass);
    }

    # Кешируем всё остальное
}

2. Настройте корректные заголовки кеширования на стороне WordPress

Добавьте в файл functions.php вашей темы или в кастомный плагин следующий код, который отключает кеширование для страниц WooCommerce:

add_action('send_headers', function() {
    if (is_cart() || is_checkout() || is_account_page()) {
        header('Cache-Control: no-store, no-cache, must-revalidate, max-age=0');
        header('Pragma: no-cache');
    }
});

3. Перезапустите Varnish и очистите кеш

После внесения изменений выполните:

sudo systemctl restart varnish
sudo varnishadm ban req.url ~ ".*"

Проверка результата

• Откройте страницу корзины в браузере в режиме инкогнито — убедитесь, что добавление товара в корзину сразу отображается.
• Проверьте HTTP-заголовки для страницы корзины — должны присутствовать Cache-Control: no-store и Pragma: no-cache.
• Используйте curl для проверки ответа сервера без кеширования:

curl -I https://example.com/cart
# Проверьте, что заголовки не содержат кеширующих директив

Частые ошибки и способы их исправления

• Все страницы кешируются, несмотря на настройки: проверьте, что vcl_recv действительно содержит все условия return (pass); для динамических URL и куков.
• Куки не передаются в Varnish: убедитесь, что Varnish не очищает куки WooCommerce в vcl_recv.
• Заголовки Cache-Control не устанавливаются: проверьте, что код в WordPress срабатывает и нет конфликтов с плагинами кеширования.
• Перезапуск Varnish не применяется: убедитесь, что в системе используется правильный конфигурационный файл.

Практические советы по безопасности и производительности

• Используйте return (pass); для динамических страниц, чтобы не кешировать персональные данные и не допустить проблем с сессиями.
• Кешируйте статичные страницы и ресурсы (CSS, JS, картинки) через Varnish для ускорения.
• Разграничивайте правила кеширования для разных ролей пользователей (например, админов) с помощью куков.
• Тестируйте изменения на staging-сервере, чтобы не допустить падения сайта при неправильной конфигурации Varnish.
• Рассмотрите использование плагинов Clearfy Pro для оптимизации и управления кешированием и SEO (https://wpshop.ru/plugins/clearfy?utm_source=wp-kit.ru&utm_medium=article&utm_campaign=kak-izbezhat-problem-s-keshirovaniem-woocommerce-pri-ispolzovanii-varnish).

Сравнение вариантов решения кеширования WooCommerce с Varnish