Предоставяне на WordPress като статичен HTML
Повечето страници на маркетингов или документационен сайт са еднакви за всички анонимни посетители. WordPress все пак се стартира, зарежда всеки плъгин, изпълнява темата и визуализира блоковете при всяка заявка. Плъгин за кеширане на страници може да помогне, но добавя още един компонент със собствени правила за това какво е безопасно да се съхранява.
Blockstudio предлага незадължително статично предварително генериране. То съхранява пълни HTML документи за анонимни посетители в собствена директория за кеш и, ако го разрешите, ги предоставя чрез drop-in advanced-cache.php, преди WordPress да се стартира. Всичко се конфигурира в blockstudio.json.
Това ръководство ви превежда стъпка по стъпка през активирането на функцията, показва как да проверите какво се кешира и какво не, обяснява единственото правило, което защитава влезлите посетители, и завършва с настройка CDN, която кешира само съдържание, обозначено от изходния сървър като годно за кеширане.
Как се обслужва заявка
При включено предварително генериране всяка подходяща заявка завършва по един от три начина:
- Ранно попадение. Drop-in модулът намира съхранен документ в картата на маршрутите и го предава поточно, преди 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 - посетители с бисквитка
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 управлява три малки части от състоянието: drop-in модул wp-content/advanced-cache.php, споделена карта на маршрутите wp-content/blockstudio-static-prerender-map.php и декларация WP_CACHE в wp-config.php. Те се инсталират при следващата заявка към администраторския панел.
Няколко правила гарантират безопасна работа при споделен хостинг и в мултисайт среда:
- Blockstudio никога не презаписва добавка за ранно обслужване, карта или ред
WP_CACHE, които не притежава. Ако друга приставка за кеширане вече притежаваadvanced-cache.php, ранното обслужване остава изключено. - Ако
WP_CACHEвече е дефинирано катоtrue,wp-config.phpне се променя. При хостове, къдетоwp-config.phpне може да се записва, дефинирайте го сами. - Преди обслужването и добавката за ранно обслужване, и пътят PHP проверяват дали файлът със стилове Tailwind, чието име съдържа хеш на съдържанието и към който сочи документът, все още съществува. Ако липсва, заявката се пренасочва към WordPress, вместо документът да се обслужи без стилове.
- Записите в Multisite споделят една карта, но са изолирани по хост, начален път и идентификатор на сайта.
- Заглавките на отговора, посочени в
replayHeaders— по подразбиранеLink— се съхраняват с всеки документ и се изпращат отново при всяко зареждане от кеша. Така заглавкаLink, изпратена от страницата сheader(), се запазва при ранно обслужване. Заглавките за бисквитки и кеширане никога не се изпращат повторно.
Ранните попадения съдържат 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"
]
}
}
}
30-дневният ttl само ограничава възрастта на обслужвания документ. Актуалността
идва от внедряването, което изгражда графа отново. Компилацията 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 по подразбиране на периферния сървър за отговори без такъв.
- Заобикаляйте периферния кеш за същите бисквитки, които 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 и заглавките изглеждат правилно. Всеки слой може да бъде върнат самостоятелно, като стойността му се върне обратно.
Следващи стъпки
- Справочник за статично предварително изобразяване: компилации на графа, активиране на артефакти, съхранение и куки за наблюдаемост.
- Производителност: какво променя профилът
speedи как да го измерите. - Кеширане: директорията на кеша, в която се съхранява всеки документ.
- Персонализирани фрагменти в кеширани страници: съдържание за отделния посетител в статични маршрути.
- Внедряване на сайт Blockstudio: къде синхронизирането, изчистването на кеша и подгряването се вписват в процеса по публикуване.