Lewati ke konten

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:

  1. Hit awal. Drop-in menemukan dokumen tersimpan di peta rutenya lalu mengirimkannya sebelum WordPress dimuat. Respons menyertakan X-Blockstudio-Static-Prerender: HIT-EARLY.
  2. Hit. WordPress dijalankan, lalu pada template_redirect Blockstudio menemukan dokumen tersimpan yang masih baru dan mengirimkannya sebagai pengganti hasil render template. Respons menyertakan X-Blockstudio-Static-Prerender: HIT.
  3. 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:

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
      }
    }
  }
}

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.enabled mendaftarkan runtime. Selama nilainya false, fitur ini tidak menulis file dan tidak mendaftarkan hook permintaan.
  • ttl adalah usia maksimum dokumen tersimpan dalam detik (default 86400).
  • dynamicPaths mencantumkan prefiks jalur yang harus selalu dirender langsung.
  • warm menjadwalkan pemanas latar belakang yang merender ulang URL publik usang setiap interval detik.

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_*, atau comment_author_email_*, kecuali serveLoggedIn diaktifkan

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:

HTML
<!-- 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:

Shell
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 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:

Shell
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_CACHE yang bukan miliknya. Jika plugin cache lain sudah memiliki advanced-cache.php, penyajian awal tetap nonaktif.
  • Jika WP_CACHE sudah ditetapkan sebagai true, wp-config.php dibiarkan apa adanya. Pada host yang tidak mengizinkan penulisan ke wp-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 default Link, disimpan bersama setiap dokumen dan dikirim kembali pada setiap hit. Dengan demikian, header Link yang dikirim halaman bersama header() 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
<?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
<?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:

JSON
{
  "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:

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;
    }
}

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 untuk dynamicPaths, wp-admin, dan wp-json Anda.
  • 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

Shell
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