Перейти к содержимому

Раздача WordPress как статического HTML

Большинство страниц маркетинговых сайтов и сайтов документации выглядят одинаково для всех анонимных посетителей. WordPress всё равно запускается, загружает все плагины, выполняет тему и отображает блоки при каждом запросе. Плагин кэширования страниц может помочь, но добавляет еще один компонент со своими правилами о том, что безопасно сохранять.

Blockstudio поддерживает статическую предварительную генерацию, которую можно включить по желанию. Она сохраняет полные документы HTML для анонимных посетителей в собственном каталоге кэша и, если разрешить, раздает их через подключаемый модуль advanced-cache.php до запуска WordPress. Все настройки находятся в blockstudio.json.

В этом руководстве мы пошагово включим эту функцию, покажем, как проверить, что попадает в кэш, разберем единственное правило безопасности для вошедших пользователей и в завершение настроим CDN так, чтобы кэшировать только то, что сервер помечает как пригодное для кэширования.

Как обрабатывается запрос

При включенной предварительной генерации подходящий запрос обрабатывается одним из трех способов:

  1. Попадание на раннем этапе. Подключаемый модуль находит сохраненный документ в карте маршрутов и передает его до загрузки WordPress. Ответ содержит X-Blockstudio-Static-Prerender: HIT-EARLY.
  2. Попадание. Запускается WordPress, и на этапе template_redirect Blockstudio находит свежий сохраненный документ и отправляет его вместо рендеринга шаблона. Ответ содержит X-Blockstudio-Static-Prerender: HIT.
  3. Промах. WordPress отображает страницу обычным способом. Если посетитель анонимный, а результат представляет собой полный документ HTML со статусом 200, Blockstudio сохраняет его для следующего запроса.

Запросы, не соответствующие критериям, вообще не обращаются к кэшу.

Шаг 1: Включение профиля и кэша

Начните с профиля производительности и предварительной генерации, отключив раннюю раздачу:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "performance": {
    "profile": "speed",
    "staticPrerender": {
      "enabled": true,
      "ttl": 86400,
      "earlyServe": false,
      "dynamicPaths": ["/account", "/checkout", "/login"],
      "warm": {
        "enabled": true,
        "interval": 900,
        "concurrency": 4
      }
    }
  }
}

Что делает каждый параметр:

  • profile: "speed" включает стандартные настройки производственного интерфейса: удаляет лишние элементы в заголовке, обнаружение oEmbed, XML-RPC и общие ресурсы ядра для интерфейса, а также предварительно загружает ссылки на том же источнике при намерении перейти по ним. Сначала проверьте удаление ресурсов интерфейса ядра: при зависимости страницы от них она будет заметно нарушена. Любое дочернее значение переопределяет профиль.
  • staticPrerender.enabled регистрирует среду выполнения. Пока установлено значение false, функция не записывает файлы и не регистрирует перехватчики запросов.
  • ttl — максимальный срок хранения документа в секундах (по умолчанию 86400).
  • dynamicPaths содержит префиксы путей, которые всегда должны обрабатываться в реальном времени.
  • warm планирует фоновое обновление, повторно отображая устаревшие общедоступные URL каждые interval секунд.

Строка $schema охватывает все ключи, поэтому редактор с поддержкой схемы JSON выявит ошибку, например "ttl": 0 (минимальное значение — 1).

Шаг 2: Какие запросы подходят

Blockstudio консервативно подходит к сохранению данных. Следующие запросы всегда обходят кэш:

  • запросы не GET
  • любой URL со строкой запроса
  • wp-admin, wp-json, wp-login.php, xmlrpc.php, Ajax и cron
  • ленты, поиск и предварительный просмотр
  • запросы с заголовком X-WP-Nonce
  • пути в dynamicPaths
  • посетители с cookie wordpress_logged_in_*, wp-postpass_* или comment_author_email_*, если не включен параметр serveLoggedIn

Динамические пути сопоставляются по границам сегментов пути. При указанной выше конфигурации:

Запрос Обходит кэш
/pricing/ нет
/account/orders/ да
/accounting/ нет
/checkout да
/pricing/?utm_source=x да
/blog/feed/ да

Сохраняются только полные документы: ответ должен начинаться с <!doctype html или <html, иметь статус 200 и не содержать маркер отказа от кэширования. Шаблон, который нельзя сохранять, может вывести этот маркер в любом месте страницы:

HTML
<!-- blockstudio:no-cache -->

Страницы ошибок никогда не сохраняются, поэтому оформленный 404 не может быть повторно выдан как успешный ответ.

Шаг 3: Проверка попаданий в кэш

Откройте несколько страниц в приватном окне, а затем запросите у Blockstudio сведения о содержимом кэша:

Командная оболочка
wp bs prerender status
JSON
{
    "enabled": true,
    "invalidate": "signature",
    "identity": "e6cdd3fcda14ad6ded85a763bd01a33b",
    "cacheRoot": ".../wp-content/blockstudio/cache/sites/.../static-prerender",
    "files": 0,
    "bytes": 0,
    "records": 0,
    "queue": {
        "pending": 0,
        "processing": 0,
        "done": 0,
        "unique": 0,
        "bytes": 0
    },
    ...
    "diagnostics": []
}

По мере сохранения документов растут files и bytes, queue показывает очередь фонового обновления, а diagnostics содержит счетчики попаданий, промахов, сборок и ошибок для каждой области. Чтобы проверить одну страницу, запросите ее дважды как анонимный посетитель и найдите заголовок:

Командная оболочка
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender

Второй ответ содержит X-Blockstudio-Static-Prerender: HIT. Используйте GET, как показано выше: curl -I отправляет запрос HEAD, который всегда обходит кэш.

Шаг 4: Раздача до запуска WordPress

Когда попадания в кэш работают правильно, установите "earlyServe": true. После этого Blockstudio управляет тремя небольшими элементами состояния: подключаемым модулем wp-content/advanced-cache.php, общей картой маршрутов wp-content/blockstudio-static-prerender-map.php и объявлением WP_CACHE в wp-config.php. Они устанавливаются при следующем запросе из панели администратора.

Несколько правил обеспечивают безопасную работу на виртуальном хостинге и в многосайтовой среде:

  • Blockstudio никогда не перезаписывает drop-in, карту или строку WP_CACHE, которыми не владеет. Если advanced-cache.php уже принадлежит другому плагину кэширования, ранняя отдача отключается.
  • Если WP_CACHE уже определён как true, wp-config.php не изменяется. На хостингах, где запись в wp-config.php невозможна, определите его самостоятельно.
  • Перед отправкой и drop-in, и путь PHP проверяют, существует ли связанная с документом таблица стилей Tailwind с хешем содержимого. Если её нет, запрос направляется в WordPress, а не обслуживается без стилей.
  • Записи Multisite используют общую карту, но изолируются по хосту, домашнему пути и ID сайта.
  • Заголовки ответа, указанные в replayHeaders (по умолчанию — Link), сохраняются вместе с каждым документом и повторно отправляются при каждом обращении. Поэтому заголовок Link, который страница отправляет вместе с header(), сохраняется при ранней отдаче. Заголовки cookie и кэширования никогда не воспроизводятся.

При ранней отдаче передаётся X-Blockstudio-Static-Prerender: HIT-EARLY. Отключение earlyServe или enabled однократно удаляет состояние, которым владеет Blockstudio, а wp bs teardown удаляет его явно для установок Composer без хука деактивации.

Авторизованные посетители и идентичная разметка

По умолчанию авторизованные посетители всегда получают динамический рендеринг. Параметр "serveLoggedIn": true позволяет им также использовать уже сохранённый документ, благодаря чему сайт работает для редакторов и клиентов так же быстро, как для анонимных посетителей.

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

Отсюда следует правило: на каждом маршруте вне dynamicPaths разметка для авторизованных пользователей должна побайтно совпадать с разметкой для анонимных. Это значит, что в шаблонах, которые отображаются на статических маршрутах, не должно быть веток is_user_logged_in() или wp_get_current_user():

PHP
<?php // Do not do this on a static route. ?>
<?php if ( is_user_logged_in() ) : ?>
  <a href="/account/">Hi, <?php echo esc_html( wp_get_current_user()->display_name ); ?></a>
<?php else : ?>
  <a href="/login/">Sign in</a>
<?php endif; ?>

Есть два простых решения. Перенесите маршрут в dynamicPaths, если вся страница персональная, например панель учётной записи. Или оставьте страницу статической и отображайте персональную часть как динамический островок блока: в сохранённом HTML он передаёт безопасную для кэширования заглушку, а затем загружает настоящий фрагмент в отдельном запросе посетителя:

PHP
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>

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

Инвалидация по сигнатуре или графу

invalidate определяет срок действия сохранённых документов.

Аспект signature (по умолчанию) graph
Кто заполняет кэш анонимные промахи и прогревщик этап сборки и анонимные промахи
Что удаляет записи по истечении срока TTL, сохранение записей, изменения на уровне сайта новая сборка; TTL задаёт верхнюю границу
Фоновый прогревщик доступен отключён
Подходит для обычных сайтов сайтов с конвейером развёртывания

Для режима signature не нужны дополнительные инструменты. Сохранение записи очищает кэш или повторно прогревает главную страницу и постоянную ссылку этой записи; изменения на уровне сайта, например смена темы, обновляют идентификатор кэша.

Режим graph предназначен для детерминированных развёртываний. На этапе сборки вычисляется план с помощью Static_Prerender_Runtime::build_plan(), отображаются только затронутые URL-адреса, записываются результаты, а готовый набор активируется атомарно с помощью Static_Prerender_Early_Serve::install_artifact_entry(). Если проверка любого упомянутого документа завершается ошибкой, предыдущий набор остаётся активным. Сопоставленные маршруты обслуживаются из активированного артефакта, пока следующая сборка его не заменит, поэтому изменения контента в wp-admin попадут на эти маршруты при следующем развёртывании. В этом режиме прогревщик на уровне URL отключён, поскольку артефакты собираются и активируются как единое целое. Типичный вариант для продакшена выглядит так:

JSON
{
  "performance": {
    "profile": "speed",
    "staticPrerender": {
      "enabled": true,
      "invalidate": "graph",
      "ttl": 2592000,
      "earlyServe": true,
      "serveLoggedIn": true,
      "dynamicPaths": [
        "/account",
        "/cart",
        "/checkout",
        "/login",
        "/reset-password"
      ]
    }
  }
}

30-дневный ttl лишь ограничивает максимальный возраст отданного документа. Актуальность обеспечивается развёртыванием, которое перестраивает граф. Сборка API, сегментирование и внутренний транспорт рендеринга описаны в справочнике Статический пререндеринг.

Настройка CDN перед сайтом

Пререндеринг уже указывает, какими ответами можно безопасно делиться: только ответами с заголовком HIT. Пусть сервер-источник преобразует его в заголовок кэширования, а CDN использует срок хранения, заданный сервером-источником. В связке с nginx перед PHP-FPM:

Nginx
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
    "~^HIT"  "public, s-maxage=604800";
    default  "";
}

server {
    listen 80;
    server_name example.com;
    root /var/www/html;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_pass unix:/run/php/php-fpm.sock;
        add_header Cache-Control $edge_cache_control;
    }
}

Регулярное выражение совпадает с HIT и HIT-EARLY. Для всех остальных ответов переменная пуста, а nginx не добавляет заголовок с пустым значением. Поэтому промахи, динамические пути и ответы для авторизованных пользователей не получают на сервере-источнике общий срок кэширования.

Со стороны CDN:

  • Кэшируйте HTML, только если сервер-источник присылает срок кэширования. Отключите стандартный TTL на узле сети для ответов без такого срока.
  • Обходите кэш узла сети для тех же cookie, которые Blockstudio считает персональными (wordpress_logged_in_, wp-postpass_, comment_author_email_), а также для ваших dynamicPaths, wp-admin и wp-json.
  • Очищайте CDN после каждого развёртывания, меняющего страницы, шаблоны или ресурсы. Кэш сервера-источника обновляется самостоятельно, а кэш узла сети об этом не знает.

Если вы используете Tailwind вместе с "output": "link", таблица стилей URL хешируется по содержимому, поэтому для этого пути можно задать долгосрочный неизменяемый заголовок кэширования.

Команды обслуживания

Командная оболочка
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown

warm ставит в очередь устаревшие публичные URL-адреса и отображает до warm.concurrency за запуск, выводя сводку JSON. purge удаляет сохранённые документы и очередь текущего сайта. teardown удаляет события cron и состояние ранней отдачи, принадлежащее этой установке, не затрагивая файлы конфигурации.

Выполняйте запуск по порядку: сначала профилирование, затем пререндеринг с отключённым earlyServe, а потом раннюю отдачу, когда status и заголовки настроены правильно. Каждый уровень можно отдельно откатить, вернув прежнее значение.

Следующие шаги