Lewati ke konten

Prerender Statis

Prerender statis adalah cache HTML anonim yang bersifat opsional. Respons yang dapat di-cache harus berupa dokumen HTML lengkap dan dapat memilih untuk tidak ikut dengan <!-- blockstudio:no-cache -->. Blockstudio melewati permintaan non-GET, string kueri, admin WordPress, REST, Ajax, cron, feed, hasil pencarian di bawah basis pencarian pada path beranda situs (seperti /search/term/), header pratinjau dan kanvas, permintaan yang memuat nonce, path dinamis yang dideklarasikan, cookie kata sandi/komentar, serta permintaan pengguna yang masuk secara default. Halaman yang path-nya hanya memuat segmen search atau preview lebih jauh di dalamnya, seperti /docs/blocks/preview/, di-cache seperti halaman lainnya.

JSON
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "invalidate": "graph",
      "earlyServe": true,
      "serveLoggedIn": false,
      "dynamicPaths": ["/account", "/checkout"],
      "replayHeaders": ["Link"],
      "warm": {
        "enabled": true,
        "interval": 900,
        "concurrency": 4,
        "transport": "http"
      }
    }
  }
}

Pengguna yang masuk dapat menggunakan hit yang sudah ada hanya jika serveLoggedIn bernilai true; respons yang dipersonalisasi tidak pernah membuat entri cache. Path dinamis menggunakan batas path, sehingga /account cocok dengan /account/orders, tetapi tidak dengan /accounting.

Saat fitur dinonaktifkan, fitur ini tidak menulis file, memasang drop-in, ataupun mendaftarkan hook permintaan atau admin. earlyServe: false juga tidak mendaftarkan callback admin Early Serve, dan warm.enabled: false tidak mendaftarkan callback cron ataupun jadwal. Menonaktifkan salah satu fitur akan menghapus status yang sebelumnya dikelolanya satu kali; permintaan berikutnya tidak melakukan pemeriksaan pembersihan filesystem atau cron.

Menonaktifkannya per lingkungan

Setiap nilai di atas juga dapat diatur dengan filter pengaturan. Blockstudio dimulai sebelum tema aktif, dari plugin atau autoload Composer milik tema, sehingga pengaturan runtime-nya ditentukan kembali setelah tema dimuat dan hook prerender statis diputuskan pada after_setup_theme. Karena itu, filter yang ditambahkan oleh plugin atau di functions.php milik tema akan berlaku:

PHP
add_filter('blockstudio/settings/performance/staticPrerender/enabled', function ($enabled) {
    return 'local' === wp_get_environment_type() ? false : $enabled;
});

Menonaktifkan fitur dengan cara ini sama seperti menonaktifkannya di blockstudio.json: tidak ada hook permintaan, konten, admin, ataupun cron yang didaftarkan, dan entri Early Serve milik situs yang sebelumnya disajikan lebih awal akan dihapus satu kali. Filter yang ditambahkan belakangan, misalnya pada init, tidak mengubah hook mana yang didaftarkan.

Mode tanda tangan dan graf

Mode signature mengisi respons dengan kunci identitas saat cache miss anonim biasa. Mode ini praktis untuk situs WordPress biasa dan berputar setelah perubahan tingkat situs.

Mode graph ditujukan untuk integrasi build/deploy deterministik. Panggil Static_Prerender_Runtime::build_plan() dengan URL sumber aktif, render hanya affectedUrls, lalu catat setiap hasil dengan persist_built_response() atau persist_skipped_response(). Rencana ini membandingkan file bersama dan hash dependensi persis untuk setiap halaman. URL yang dihapus dan HTML yang tidak dirujuk akan dihapus oleh garbage_collect().

PHP
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
    $result = render_with_dependencies($url);

    Static_Prerender_Runtime::persist_built_response(
        $url,
        $result['html'],
        $result['files'],
        $result['virtualHashes']
    );
}

$targets = array_keys($plan['live']);
Static_Prerender_Runtime::garbage_collect($targets);

Argumen host/beranda target opsional menulis ulang rute untuk deployment tanpa menggunakan path halaman pertama sebagai root situs. Alat batch dapat menggunakan Static_Prerender_Batch_Renderer::render() dan shard N/TOTAL yang stabil; Static_Prerender_Batch_Renderer::parse_shard() dan select_shard() mendukung opsi shard, sehingga pemanggil dapat menghitung partisi yang sama dengan perender. Di dalam build, Static_Prerender_Batch_Renderer::is_rendering() menjawab apakah permintaan saat ini adalah render batch, bukan pengunjung, sehingga templat dapat melewati pekerjaan yang tidak seharusnya dijalankan selama build. Transport internal disediakan oleh filter generik blockstudio/static_prerender/render_internal; fallback HTTP opsional menggunakan header warm biasa.

Hal yang dilacak mode graf

Dengan transport HTTP default, Static_Prerender_Batch_Renderer::render() mengirim token bertanda tangan pada setiap permintaan warm, dan permintaan tersebut melaporkan file yang dibacanya: WordPress templat yang dimuat, templat setiap blok Blockstudio yang dirender, file templat dan file aset, file yang ditambahkan melalui blockstudio/render/dependencies, serta, untuk halaman tersinkron, file definisi, templat, konten, dan tata letaknya. Laporan ditulis ke direktori cache situs, yang sudah digunakan bersama oleh perender dan server web untuk HTML hasil render. Pada build berikutnya, build_plan() melakukan hash ulang file tersebut dan menandai hanya rute yang filenya berubah, beserta rute baru, rute yang melewati ttl, dan semua rute jika file bersama berubah (blockstudio.json, theme.json, style.css, functions.php, header.php, footer.php, semua yang berada di bawah inc/, parts/, dan templates/, serta sumber aset UI yang dibundel oleh Blockstudio). Tanda tangan bersama melakukan hash pada sumber, bukan output yang dikompilasi, sehingga file _dist yang dikompilasi oleh render pertama build tidak mengubahnya: artifact_entry() memperoleh ID build dari tanda tangan yang sama dengan yang dilihat build_plan() sebelum perenderan.

Konten yang hanya ada di basis data bukan file dan tidak dilacak: postingan yang diedit di admin, opsi, baris yang dibuat, atau harga. Build yang perlu mengambil perubahan tersebut meneruskan $force ke build_plan() atau merender sendiri URL yang terdampak. Transport internal mencatat dependensi yang dikembalikan filternya.

Penyajian awal dan deployment atomik

Dengan earlyServe aktif, Blockstudio mengelola wp-content/blockstudio-static-prerender-map.php kecil, drop-in advanced-cache.php, dan satu deklarasi WP_CACHE yang persis. Drop-in membaca peta rute per situs dan mengalirkan hit yang memenuhi syarat sebelum WordPress, plugin, atau tema dimulai.

Blockstudio tidak pernah menimpa peta, drop-in, atau deklarasi WP_CACHE milik pihak lain. Artefak graf memvalidasi setiap file HTML yang dirujuk sebelum peta ditukar; graf sebelumnya tetap aktif jika validasi gagal. Entri multisite berbagi peta, tetapi dipisahkan berdasarkan host, path beranda, dan ID situs. Menonaktifkan fitur atau menonaktifkan Blockstudio hanya menghapus entri situs saat ini, dan artefak bersama hanya dihapus setelah entri terakhir yang dikelola hilang.

Alat deployment dapat mengaktifkan graf yang telah dirender sepenuhnya secara atomik:

PHP
$entry = Static_Prerender_Runtime::artifact_entry($targetUrls);

Blockstudio\Static_Prerender_Early_Serve::install_artifact_entry(
    $entry,
    Static_Prerender_Runtime::cache_root_path()
);

Konfigurasi tetap menjadi sumber otoritatif. install_artifact_entry() mengembalikan false kecuali enabled dan earlyServe sama-sama true, sehingga deployment tidak akan memasang peta, drop-in, dan deklarasi WP_CACHE yang kemudian akan dihapus lagi oleh permintaan admin berikutnya.

install_artifact_entry() mempertahankan build_id milik entri, sehingga deployment dapat membandingkannya dengan entri yang dikembalikan installed_map_entries() sesudahnya. Peta adalah file PHP yang dibaca dengan include, dan setiap penulisan menghapusnya dari cache opcode, sehingga pembacaan tersebut melihat entri baru dalam proses yang sama, bahkan saat opcache.enable_cli aktif.

Memasang artefak mempromosikan dokumennya ke cakupan artefak khusus yang tidak pernah disentuh oleh pemangkasan retensi, dan file yang dirujuk peta terlindung dari penghapusan di mana pun lokasinya. Dengan demikian, lalu lintas render aktif tidak dapat membuat rute yang dipetakan kedaluwarsa dari penyajian awal. Kunci rute tidak sepenuhnya beralamat konten, sehingga render ulang dapat mengubah dokumen tanpa mengubah kuncinya; pemasangan membandingkan byte dan mengganti dokumen artefak yang berbeda secara atomik, membiarkan dokumen yang identik, serta mempertahankan dokumen artefak yang salinan penyimpanannya telah hilang. Static_Prerender_Early_Serve::last_promotion() melaporkan jumlah rute yang dipromosikan, diganti, dilewati, atau dipertahankan oleh pemasangan terakhir, sehingga deployment dapat mencatatnya.

Dokumen tersimpan mengunci aset build yang ditautkannya melalui URL, dan file tersebut memiliki retensinya sendiri, sehingga salah satunya dapat bertahan lebih lama daripada yang lain. Sebelum disajikan, baik cache PHP maupun drop-in memeriksa apakah stylesheet Tailwind ber-hash konten yang ditautkan masih ada di disk. Dokumen yang stylesheet-nya hilang diteruskan ke WordPress alih-alih disajikan tanpa gaya; proses ini menerbitkan ulang stylesheet dan dokumen secara bersamaan. Pemeriksaan yang sama dilakukan sebelum respons disimpan, sehingga dokumen yang tidak dapat disajikan tidak pernah ditulis.

Permintaan yang header Accept-nya berisi text/markdown melewati penyimpanan PHP dan drop-in, karena dokumen tersimpan bersifat HTML dan halaman dapat menjawab permintaan tersebut dengan Markdown sumber . Karena itu, dokumen yang disajikan mengirim Vary: Accept. Memperbarui Blockstudio akan menulis ulang drop-in lama pada penulisan peta berikutnya.

Rute graf yang dipetakan selalu menggunakan artefak yang diaktifkan. Jika rute anonim yang aman tidak ada di peta tersebut, tetapi WordPress telah merender dan menyimpannya, Early Serve menggunakan penyimpanan runtime berkunci identitas sebelum memulai WordPress. Ini mendukung rute yang dibuat atau berekor panjang di luar graf deployment yang sengaja dibatasi. Fallback menggunakan identitas graf yang diaktifkan serta aturan host, normalisasi path, TTL, cookie, header, string kueri, path dinamis, dan pengecualian feed yang sama dengan rute yang dipetakan. Fallback hanya menemukan dokumen yang disimpan oleh runtime, yang tidak pernah mencakup hasil pencarian.

Header respons

Dokumen tersimpan diputar ulang tanpa permintaan yang merendernya, sehingga header yang dikirim tema atau plugin dengan header() akan hilang dari setiap hit. Blockstudio menyimpan header yang tercantum di replayHeaders bersama setiap dokumen dan mengirimkannya kembali dari cache PHP maupun drop-in penyajian awal. Pengaturan default, ["Link"], mencakup header seperti alternatif Markdown (rel="alternate"; type="text/markdown"), rel="describedby", atau rel="canonical". Nama header dicocokkan tanpa membedakan huruf besar-kecil, dan filter pengaturan mengubah daftarnya seperti nilai lainnya:

PHP
add_filter('blockstudio/settings/performance/staticPrerender/replayHeaders', function (array $headers): array {
    $headers[] = 'X-Robots-Tag';

    return $headers;
});

Atur replayHeaders ke [] untuk menonaktifkan pemutaran ulang header. Daftar eksplisit menggantikan nilai default, jadi sertakan Link saat menambahkan nama header lain jika Anda tetap ingin memutar ulang header tautan.

Header diambil dalam proses yang merender halaman: dari headers_list() saat cache miss langsung disimpan, dan dari permintaan pemanasan itu sendiri saat build atau pemanas merender di atas HTTP. Karena itu, header yang ditambahkan sendiri oleh server web dan ditambahkan lagi ke setiap dokumen yang disajikan tidak pernah disimpan. Header dari responsnya hanya digunakan jika render HTTP tidak menulis laporan. Transport internal mengembalikannya sebagai headers dalam hasilnya, dan persist_built_response() menerimanya sebagai argumen terakhir, baik dalam bentuk baris Name: value maupun peta nama ke nilai.

Header ditulis ke <key>.headers.json di samping dokumen, ikut serta saat artefak dipromosikan, pengumpulan sampah, dan pemangkasan retensi, serta dihapus jika render ulang tidak mengirim header apa pun. Header cookie, cache, dan transport tidak pernah disimpan atau diputar ulang, meskipun tercantum: Set-Cookie, Cache-Control, Expires, Pragma, Age, ETag, Last-Modified, Vary, Content-Type, Content-Length, Content-Encoding, Transfer-Encoding, Location, Status, Date, serta header hop-by-hop dan autentikasi. Dokumen yang disajikan menetapkan Content-Type dan Vary sendiri.

Header tersimpan diperiksa kembali terhadap daftar saat dikirim. Cache PHP membaca pengaturan terbaru; drop-in membaca salinan dalam entri peta situs, yang diperbarui saat artefak berikutnya dipasang atau peta disinkronkan. Dokumen yang disimpan sebelum peningkatan versi tidak memiliki file header dan disajikan seperti sebelumnya sampai dirender ulang.

Pemanasan, pemeliharaan, dan observabilitas

Antrean warm bersifat persisten, digabungkan berdasarkan URL, hanya menjalankan satu pekerjaan pada satu waktu, dan memulihkan klaim yang kehabisan waktu. Perubahan konten dan situs memaksa pekerjaan pengganti meskipun tanda tangan saat ini tidak berubah; proses berkala hanya mengantrekan pekerjaan yang usang. Setiap proses, baik terjadwal maupun melalui wp bs prerender warm, merender hingga warm.concurrency pekerjaan. Mode graph menonaktifkan warmer per-URL, karena artefak graf dibangun dan diaktifkan sebagai satu kesatuan.

Shell
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs prerender map status
wp bs prerender map prune --dry-run

status melaporkan identitas aktif, file, byte, catatan graf, status antrean, laporan peta Early Serve, serta penghitung hit/miss/build/kegagalan per cakupan.

Peta Early Serve digunakan bersama oleh setiap situs dalam satu instalasi. map status (dan Static_Prerender_Early_Serve::map_report()) mencantumkan entri yang tidak lagi dapat digunakan oleh penyajian awal: entri orphaned untuk situs yang sudah tidak ada dan entri dead yang direktorinya telah hilang, serta jumlah dokumen rute missing dalam entri yang tersisa. map prune (Static_Prerender_Early_Serve::prune_map()) menghapus entri yatim dan tidak aktif di bawah kunci peta serta melaporkan alasan masing-masing; --dry-run hanya melaporkan. Penghapusan entri terakhir juga menghapus peta, drop-in, dan deklarasi WP_CACHE. Menghapus situs dari jaringan multisite langsung menghapus entri-entrinya, dan pembersihan cache tidak pernah mengumpulkan namespace tempat artefak yang diaktifkan disajikan, sehingga entri hanya menjadi tidak aktif jika filenya dihapus dengan cara lain.

Amati hasil setiap respons dengan blockstudio/static_prerender/outcome dan semua hasil cache bersama dengan blockstudio/cache/outcome.

Penghapusan

Instalasi tanpa hook penonaktifan plugin, seperti pengaturan yang dibundel dengan Composer, dapat menghapus semua yang dikelola fitur ini melalui satu perintah:

Shell
wp bs teardown

Perintah ini menghapus peristiwa cron dan status prerender statis yang dikelola instalasi: entri peta situs saat ini, serta drop-in bersama dan deklarasi WP_CACHE setelah entri terakhir yang dikelola hilang. File konfigurasi tidak diubah, sehingga fitur dapat diaktifkan kembali dengan bersih.

Mengadopsinya di lingkungan produksi

Urutan penerapan yang wajar:

  1. Atur performance.profile ke speed, lalu periksa output head, feed, dan plugin apa pun yang bergantung pada oEmbed atau XML-RPC.
  2. Buat assets/media.json, pindahkan templat ke bs_media_image(), lalu aktifkan performance.media.lazy.
  3. Aktifkan performance.staticPrerender dengan earlyServe nonaktif, verifikasi hit dengan wp bs prerender status, lalu aktifkan earlyServe.

Rollback dilakukan per fitur: mengatur staticPrerender.enabled ke false akan menghapus status Early Serve yang dikelola Blockstudio dan jadwal warm satu kali, lalu membiarkan runtime prerender tidak terdaftar. Mengatur performance.profile kembali ke compat membatalkan profil. Masing-masing membiarkan lapisan lainnya tetap aktif.

Performa

Profil, profiler, dan teknik render yang mendasarinya.

Caching

Satu direktori cache yang menampung setiap artefak yang dibuat.