Menyajikan WordPress sebagai HTML Statis
Sebagian besar halaman situs pemasaran atau dokumentasi tampil sama bagi setiap pengunjung anonim. WordPress tetap dijalankan, memuat semua plugin, menjalankan tema, dan merender blok pada setiap permintaan. Plugin cache halaman dapat membantu, tetapi menambah satu komponen lagi dengan aturan penyimpanan amannya sendiri.
Blockstudio menyediakan prerender statis opsional. Fitur ini menyimpan dokumen HTML anonim secara lengkap di direktori cache tersendiri dan, jika diizinkan, menyajikannya dari drop-in advanced-cache.php sebelum WordPress dijalankan. Semua pengaturan ada di blockstudio.json.
Panduan ini mengaktifkan fitur selangkah demi selangkah, menunjukkan cara memeriksa apa yang di-cache dan tidak di-cache, menjelaskan satu aturan yang melindungi pengunjung yang sudah login, lalu diakhiri dengan konfigurasi CDN yang hanya meng-cache konten yang ditandai oleh origin sebagai layak di-cache.
Cara permintaan disajikan
Saat prerender diaktifkan, permintaan yang memenuhi syarat akan berakhir melalui salah satu dari tiga cara:
- Hit awal. Drop-in menemukan dokumen tersimpan di peta rutenya lalu mengirimkannya sebelum WordPress dimuat. Respons menyertakan
X-Blockstudio-Static-Prerender: HIT-EARLY. - Hit. WordPress dijalankan, lalu pada
template_redirectBlockstudio menemukan dokumen tersimpan yang masih baru dan mengirimkannya sebagai pengganti hasil render template. Respons menyertakanX-Blockstudio-Static-Prerender: HIT. - Miss. WordPress merender halaman seperti biasa. Jika pengunjung anonim dan hasilnya berupa dokumen HTML lengkap dengan status 200, Blockstudio menyimpannya untuk permintaan berikutnya.
Permintaan yang tidak memenuhi syarat sama sekali tidak mengakses cache.
Langkah 1: Aktifkan profil dan cache
Mulailah dengan profil performa dan prerender, sementara penyajian awal dinonaktifkan:
{
"$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
}
}
}
}
Fungsi setiap bagian:
profile: "speed"mengaktifkan pengaturan default frontend produksi: elemen head yang tidak perlu, penemuan oEmbed, XML-RPC, dan aset frontend inti umum dihapus, serta tautan same-origin di-prefetch saat ada niat. Penghapusan aset frontend inti adalah pengaturan yang perlu diuji lebih dulu, karena halaman yang bergantung padanya akan tampak rusak. Nilai anak mana pun akan menggantikan profil.staticPrerender.enabledmendaftarkan runtime. Selama nilainyafalse, fitur ini tidak menulis file dan tidak mendaftarkan hook permintaan.ttladalah usia maksimum dokumen tersimpan dalam detik (default86400).dynamicPathsmencantumkan prefiks jalur yang harus selalu dirender langsung.warmmenjadwalkan pemanas latar belakang yang merender ulang URL publik usang setiapintervaldetik.
Baris $schema mencakup setiap kunci, sehingga editor dengan dukungan skema JSON akan menandai kesalahan seperti "ttl": 0 (nilai minimum adalah 1).
Langkah 2: Pahami apa yang memenuhi syarat
Blockstudio menerapkan aturan ketat untuk hal yang disimpan. Permintaan berikut selalu melewati cache:
- apa pun selain
GET - URL apa pun yang memiliki string kueri
wp-admin,wp-json,wp-login.php,xmlrpc.php, Ajax, dan cron- feed, pencarian, dan jalur pratinjau
- permintaan yang mengirim header
X-WP-Nonce - jalur di bawah
dynamicPaths - pengunjung dengan cookie
wordpress_logged_in_*,wp-postpass_*, ataucomment_author_email_*, kecualiserveLoggedIndiaktifkan
Jalur dinamis dicocokkan berdasarkan batas jalur. Dengan konfigurasi di atas:
| Permintaan | Dilewati |
|---|---|
/pricing/ |
tidak |
/account/orders/ |
ya |
/accounting/ |
tidak |
/checkout |
ya |
/pricing/?utm_source=x |
ya |
/blog/feed/ |
ya |
Saat menyimpan, hanya dokumen lengkap yang disimpan: respons harus diawali dengan <!doctype html atau <html, memiliki status 200, dan tidak boleh berisi penanda opt-out. Template yang tidak boleh disimpan dapat mencetak penanda tersebut di bagian mana pun pada halaman:
<!-- blockstudio:no-cache -->
Halaman error tidak pernah disimpan, sehingga 404 bertema tidak mungkin diputar ulang sebagai halaman sukses.
Langkah 3: Verifikasi hit
Kunjungi beberapa halaman di jendela privat, lalu tanyakan kepada Blockstudio apa saja yang tersimpan:
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 dan bytes bertambah saat dokumen disimpan, queue menunjukkan antrean pemanas, dan diagnostics memuat penghitung hit, miss, build, dan kegagalan per cakupan. Untuk memeriksa satu halaman, minta halaman itu dua kali sebagai pengunjung anonim dan cari header:
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender
Respons kedua menyertakan X-Blockstudio-Static-Prerender: HIT. Gunakan GET seperti di atas: curl -I mengirim permintaan HEAD yang selalu melewati cache.
Langkah 4: Sajikan sebelum WordPress dijalankan
Setelah hit terlihat benar, atur "earlyServe": true. Blockstudio kemudian mengelola tiga bagian kecil: drop-in wp-content/advanced-cache.php, peta rute bersama wp-content/blockstudio-static-prerender-map.php, dan deklarasi WP_CACHE di wp-config.php. Semuanya dipasang pada permintaan admin berikutnya.
Beberapa aturan berikut menjaga keamanan di hosting bersama dan multisite:
- Blockstudio tidak pernah menimpa drop-in, peta, atau baris
WP_CACHEyang bukan miliknya. Jika plugin cache lain sudah memilikiadvanced-cache.php, penyajian awal tetap nonaktif. - Jika
WP_CACHEsudah ditetapkan sebagaitrue,wp-config.phpdibiarkan apa adanya. Pada host yang tidak mengizinkan penulisan kewp-config.php, tetapkan sendiri. - Sebelum menyajikan konten, baik drop-in maupun jalur PHP memeriksa apakah stylesheet Tailwind dengan hash konten yang ditautkan oleh dokumen masih ada. Jika tidak, permintaan diteruskan ke WordPress alih-alih disajikan tanpa gaya.
- Entri multisite berbagi satu peta, tetapi dipisahkan berdasarkan host, jalur home, dan ID situs.
- Header respons yang tercantum di
replayHeaders, secara defaultLink, disimpan bersama setiap dokumen dan dikirim kembali pada setiap hit. Dengan demikian, headerLinkyang dikirim halaman bersamaheader()tetap tersedia saat penyajian awal. Header cookie dan cache tidak pernah diputar ulang.
Hit awal membawa X-Blockstudio-Static-Prerender: HIT-EARLY. Menonaktifkan earlyServe atau enabled akan menghapus status yang dimiliki Blockstudio satu kali, dan wp bs teardown menghapusnya secara eksplisit untuk instalasi Composer yang tidak memiliki hook penonaktifan.
Pengunjung yang sudah masuk dan markup yang identik
Secara default, pengunjung yang sudah masuk selalu mendapatkan render langsung. Dengan mengatur "serveLoggedIn": true, mereka juga dapat menggunakan dokumen tersimpan yang sudah ada, sehingga situs sama cepatnya bagi editor dan pelanggan seperti bagi pengunjung anonim.
Respons yang dipersonalisasi tidak pernah membuat entri cache: permintaan pengunjung yang sudah masuk dan tidak menemukan cache akan dirender langsung tanpa disimpan. Dampaknya mudah terlewat. Saat serveLoggedIn aktif, pengunjung yang sudah masuk akan mendapatkan dokumen anonim jika tersedia, dan hanya mendapatkan render langsung yang dipersonalisasi jika tidak ada. Cabang template apa pun yang bergantung pada pengguna saat ini hanya muncul saat cache tidak ditemukan, sehingga halaman berubah antar kunjungan dan cabang yang dipersonalisasi praktis tidak pernah digunakan pada rute yang di-cache.
Aturan selanjutnya: pada setiap rute di luar dynamicPaths, markup untuk pengguna yang sudah masuk harus identik byte demi byte dengan markup anonim. Artinya, jangan gunakan cabang is_user_logged_in() atau wp_get_current_user() dalam template yang dirender pada rute statis:
<?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; ?>
Ada dua solusi yang jelas. Pindahkan rute ke dynamicPaths jika seluruh halaman bersifat personal, seperti dasbor akun. Atau pertahankan halaman sebagai statis dan render bagian personal sebagai pulau blok dinamis, yang mengirim placeholder aman untuk cache dalam HTML tersimpan dan mengambil fragmen sebenarnya melalui permintaan pengunjung itu sendiri:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
Panduan Fragmen yang Dipersonalisasi di Halaman yang Di-cache menjelaskan cara membuat blok tersebut.
Invalidasi tanda tangan atau grafik
invalidate menentukan cara kedaluwarsa dokumen yang tersimpan.
| Aspek | signature (default) |
graph |
|---|---|---|
| Pihak yang mengisi cache | permintaan anonim yang tidak menemukan cache dan proses pemanasan | langkah build Anda, ditambah permintaan anonim yang tidak menemukan cache |
| Hal yang mengakhiri masa berlaku entri | TTL, penyimpanan kiriman, perubahan tingkat situs | build baru, dengan TTL sebagai batas maksimum |
| Proses pemanasan latar belakang | tersedia | nonaktif |
| Cocok untuk | situs biasa | situs dengan pipeline deployment |
Mode signature tidak memerlukan alat tambahan. Menyimpan kiriman akan menghapus cache atau memanaskan ulang halaman beranda dan permalink kiriman tersebut, sementara perubahan tingkat situs seperti pergantian tema akan mengubah identitas cache.
Mode graph ditujukan untuk deployment deterministik. Sebuah build menghitung rencana dengan Static_Prerender_Runtime::build_plan(), merender hanya URL yang terdampak, mencatat setiap hasil, lalu mengaktifkan seluruh set yang selesai secara atomik dengan Static_Prerender_Early_Serve::install_artifact_entry(). Jika validasi dokumen yang dirujuk gagal, set sebelumnya tetap aktif. Rute yang dipetakan disajikan dari artefak aktif hingga build berikutnya menggantikannya, sehingga konten yang diedit di wp-admin akan menjangkau rute tersebut pada deployment berikutnya. Proses pemanasan per-URL dinonaktifkan dalam mode ini karena artefak dibuat dan diaktifkan sebagai satu kesatuan. Bentuk produksi yang umum terlihat seperti ini:
{
"performance": {
"profile": "speed",
"staticPrerender": {
"enabled": true,
"invalidate": "graph",
"ttl": 2592000,
"earlyServe": true,
"serveLoggedIn": true,
"dynamicPaths": [
"/account",
"/cart",
"/checkout",
"/login",
"/reset-password"
]
}
}
}
ttl 30 hari hanya membatasi usia maksimum dokumen yang disajikan. Kesegaran berasal dari deployment yang membangun ulang grafik. API build, sharding, dan transport render internal dibahas dalam referensi Prarender Statis.
Menempatkan CDN di depan
Prarender sudah memberi tahu Anda respons mana yang aman untuk dibagikan: tepatnya respons yang membawa header HIT. Biarkan origin mengubahnya menjadi header cache dan biarkan CDN mengikuti origin. Dengan nginx di depan 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;
}
}
Ekspresi reguler cocok dengan HIT dan HIT-EARLY. Untuk setiap respons lainnya, variabelnya kosong dan nginx tidak menambahkan header dengan nilai kosong. Karena itu, permintaan yang tidak menemukan cache, jalur dinamis, dan render untuk pengguna yang sudah masuk tidak mendapat masa berlaku cache bersama dari origin.
Di sisi CDN:
- Cache HTML hanya jika origin mengirim masa berlaku cache. Nonaktifkan TTL edge default untuk respons yang tidak memilikinya.
- Lewati edge untuk cookie yang sama dengan yang dianggap personal oleh Blockstudio (
wordpress_logged_in_,wp-postpass_,comment_author_email_), serta untukdynamicPaths,wp-admin, danwp-jsonAnda. - Bersihkan CDN setelah setiap deployment yang mengubah halaman, template, atau aset. Cache origin berganti sendiri; edge tidak tahu bahwa cache perlu dibersihkan.
Jika Anda menggunakan Tailwind dengan "output": "link", stylesheet URL menggunakan hash konten, sehingga jalur tersebut dapat disajikan dengan header cache immutable berumur panjang.
Perintah pemeliharaan
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown
warm memasukkan URL publik yang kedaluwarsa ke antrean dan merender hingga warm.concurrency URL per proses, lalu mencetak ringkasan JSON. purge menghapus dokumen tersimpan dan antrean situs saat ini. teardown menghapus peristiwa cron dan status penyajian awal yang dimiliki instalasi ini, serta membiarkan file konfigurasi tetap utuh.
Lakukan peluncuran dengan urutan ini: profil terlebih dahulu, lalu prarender dengan earlyServe nonaktif, kemudian penyajian awal setelah status dan header terlihat benar. Setiap lapisan dapat dikembalikan sendiri dengan mengatur nilainya kembali.
Langkah berikutnya
- Referensi Prarender Statis: build grafik, aktivasi artefak, retensi, dan hook observabilitas.
- Performa: perubahan yang dibuat oleh profil
speeddan cara mengukurnya. - Caching: direktori cache tempat semua dokumen tersimpan berada.
- Fragmen yang Dipersonalisasi di Halaman yang Di-cache: konten per pengunjung di rute statis.
- Deployment Situs Blockstudio: penempatan sinkronisasi halaman, pembersihan cache, dan pemanasan dalam suatu rilis.