Обслуговування WordPress як статичного HTML
Більшість сторінок маркетингових сайтів і сайтів документації однакові для всіх анонімних відвідувачів. WordPress усе одно запускається, завантажує кожен плагін, виконує тему й відображає блоки для кожного запиту. Плагін кешування сторінок може допомогти, але це ще один компонент зі своїми правилами безпечного зберігання.
Blockstudio постачається з необов’язковим статичним попереднім рендерингом. Він зберігає повні анонімні документи HTML у власному каталозі кешу, а якщо дозволити — видає їх із розширення advanced-cache.php до запуску WordPress. Усі параметри налаштовуються в blockstudio.json.
У цьому посібнику описано, як крок за кроком увімкнути цю функцію, перевірити, що кешується, пояснено єдине правило безпеки для авторизованих відвідувачів, а наприкінці наведено налаштування CDN, яке кешує лише те, що джерело позначає як придатне для кешування.
Як обслуговується запит
Якщо попередній рендеринг увімкнено, обробка відповідного запиту завершується одним із трьох способів:
- Раннє влучання. Розширення знаходить збережений документ у карті маршрутів і передає його потоком до завантаження WordPress. Відповідь містить
X-Blockstudio-Static-Prerender: HIT-EARLY. - Влучання. Запускається WordPress, а на етапі
template_redirectBlockstudio знаходить свіжий збережений документ і надсилає його замість відображення шаблону. Відповідь міститьX-Blockstudio-Static-Prerender: HIT. - Промах. WordPress відображає сторінку звичайним чином. Якщо відвідувач анонімний, а результат — повний документ HTML зі статусом 200, Blockstudio зберігає його для наступного запиту.
Запити, що не відповідають критеріям, узагалі не звертаються до кешу.
Крок 1: Увімкнення профілю та кешу
Спочатку ввімкніть профіль продуктивності й попередній рендеринг, залишивши ранню видачу вимкненою:
{
"$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 і не містити маркера відмови від кешування. Шаблон, який ніколи не слід зберігати, може вивести цей маркер будь-де на сторінці:
<!-- blockstudio:no-cache -->
Сторінки помилок ніколи не зберігаються, тож оформлений у темі 404 ніколи не буде повторно виданий як успішна відповідь.
Крок 3: Перевірка влучань
Відвідайте кілька сторінок у приватному вікні, а потім запитайте в Blockstudio, що воно зберігає:
wp bs prerender status
{
"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 // 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 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 вимкнений, адже артефакти збираються й активуються як єдине ціле. Типова конфігурація для робочого середовища виглядає так:
{
"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:
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 і заголовки налаштовано правильно. Кожен рівень можна окремо відкотити, повернувши попереднє значення.
Наступні кроки
- Довідник зі статичного попереднього рендерення: збирання графа, активація артефактів, зберігання та хуки спостережуваності.
- Продуктивність: що змінює профіль
speedі як це виміряти. - Кешування: каталог кешу, де зберігається кожен документ.
- Персоналізовані фрагменти на кешованих сторінках: вміст для окремих відвідувачів на статичних маршрутах.
- Розгортання сайту Blockstudio: місце синхронізації сторінок, очищення кешу та прогрівання в процесі випуску.