Перейти до вмісту

Обслуговування 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"
      ]
    }
  }
}

ttl на 30 днів лише обмежує максимальний вік документа, що обслуговується. Актуальність забезпечує розгортання, під час якого перебудовується граф. У довіднику Статичне попереднє рендерення описано збирання, розбиття на сегменти та внутрішнє транспортування для рендерення за допомогою 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 має хеш вмісту, тож цей шлях можна кешувати надовго із заголовком immutable.

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

Командна оболонка
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 і заголовки налаштовано правильно. Кожен рівень можна окремо відкотити, повернувши попереднє значення.

Наступні кроки