Lewati ke konten

Statis jika memungkinkan

Halaman yang dirender lebih awal dan setelan bawaan produksi, diatur dalam blockstudio.json.

Prarender halaman anonim

Prarender statis nonaktif secara bawaan. Aktifkan performance.staticPrerender dan Blockstudio untuk menyimpan setiap dokumen HTML lengkap yang diterima pengunjung anonim, lalu melayani pengunjung anonim berikutnya dari salinan tersebut.

Permintaan yang harus tetap dilayani langsung tidak pernah mengaksesnya: permintaan non-GET, string kueri, admin, REST, Ajax, cron, feed, pencarian, pratinjau, halaman yang memuat nonce, semua path di bawah dynamicPaths, serta pengunjung yang sudah login kecuali serveLoggedIn aktif.

blockstudio.json
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}

Nonaktif secara bawaan

Tidak ada yang berubah sampai blockstudio.json menyebutkan fitur tersebut.

Path dinamis

Path dinamis /account mencakup /account/orders, tetapi tidak mencakup /accounting.

Penanda pengecualian

Komentar blockstudio:no-cache membuat respons apa pun tidak masuk ke cache.

Pengunjung yang sudah login

Dengan serveLoggedIn, mereka membaca halaman tersimpan; halaman milik mereka sendiri tidak pernah disimpan.

Pengecualian kustom

Filter static_prerender/request_bypass mengecualikan permintaan apa pun yang Anda tentukan, misalnya permintaan dengan cookie keranjang, dari halaman tersimpan.

Antrean pemanasan

Antrean persisten merender ulang halaman usang sesuai interval yang Anda tetapkan.

Rute ekor panjang

Rute di luar peta deploy juga disajikan lebih awal, setelah WordPress merender dan menyimpannya.

Pemeriksaan stylesheet

Halaman tersimpan dengan stylesheet Tailwind tertaut yang sudah tidak ada akan dirender ulang, sehingga halaman tidak pernah disajikan tanpa gaya.

Disajikan sebelum WordPress dimulai

Saat earlyServe aktif, Blockstudio memasang drop-in advanced-cache.php yang mengalirkan halaman tersimpan sebelum WordPress, plugin, atau tema dimuat. Fitur ini tidak pernah menimpa drop-in, peta rute, atau baris WP_CACHE yang tidak dibuatnya.

Situs ini menjalankannya. Pada 8 Oktober, halaman blockstudio.dev 2026 merespons dengan x-blockstudio-static-prerender: HIT-EARLY, header yang dikirim drop-in.

Terminal
# Identity, files, queue, and hit/miss counters
wp bs prerender status

# Re-render stale entries now
wp bs prerender warm

# Dead or orphaned early-serve map entries
wp bs prerender map status
wp bs prerender map prune --dry-run

# Remove the drop-in and map this install owns
wp bs teardown

Diperbarui setelah setiap perubahan

Mode bawaan signature mengisi cache saat halaman anonim tidak ditemukan dan memperbaruinya setelah perubahan di tingkat situs. Menyimpan atau menghapus pos menghapus pos tersebut dan halaman depan dari cache, atau mengantrekannya untuk dirender ulang jika pemanasan aktif.

Mode graph ditujukan untuk alat deploy. Mode ini mencatat berkas yang dibaca setiap halaman, sehingga build hanya merender ulang rute yang berkasnya berubah, lalu mengaktifkan set baru sebagai satu artefak. Jika validasi berkas yang dirujuk gagal, artefak sebelumnya tetap aktif.

Saat memasang artefak, byte dibandingkan dan dokumen yang berubah ditukar secara atomik. last_promotion() melaporkan jumlah rute yang dipromosikan, diganti, dilewati, atau dipertahankan, sehingga deploy dapat mencatatnya dan membandingkan ID build yang aktif.

deploy.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']
  );
}

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

Di balik CDN

Header prerender sudah menunjukkan respons mana yang aman untuk dibagikan. Petakan HIT dan HIT-EARLY ke masa berlaku Cache-Control di origin, cache hanya respons yang membawa masa berlaku tersebut, dan lewati edge untuk cookie wordpress_logged_in_, wp-postpass_, dan comment_author_email_, serta dynamicPaths, wp-admin, dan wp-json milik Anda.

Halaman yang di-cache di edge tetap menautkan stylesheet dengan hash konten yang digunakan saat halaman dirender. Naikkan cache.namespaceGrace hingga sebesar masa terlama salinan tersebut dapat disimpan, dan stylesheet yang sudah tidak digunakan akan tetap berada di disk sampai masa itu berakhir.

nginx.conf
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
  "~^HIT"  "public, s-maxage=604800";
  default  "";
}

location ~ \.php$ {
  include fastcgi_params;
  fastcgi_pass unix:/run/php/php-fpm.sock;
  add_header Cache-Control $edge_cache_control;
}

Satu blok dinamis di halaman yang di-cache

Atur blockstudio.island ke dynamic agar halaman yang di-cache memuat placeholder sebagai pengganti blok. Browser mengumpulkan semua pulau dinamis di halaman dan mengambil fragmennya dalam satu permintaan gabungan; setiap fragmen ditandatangani dengan nama blok dan atribut yang diizinkan.

hydrate mempertahankan seluruh HTML di halaman dan hanya mengirimkan event mount. Pulau dinamis dapat menunggu hingga terlihat, diperbarui saat event window terpicu, dan menyimpan fragmen dalam cache untuk tiap pengguna atau secara global.

block.json
{
  "name": "acme/cart-count",
  "title": "Cart count",
  "blockstudio": {
    "island": {
      "mode": "dynamic",
      "attributes": ["productId"],
      "loading": "visible",
      "event": "cart:updated",
      "cache": {
        "ttl": 60,
        "per": "user"
      }
    }
  }
}

Lihat penggunaan waktu render

Tambahkan ?blockstudio-perf ke frontend URL mana pun, lalu panel akan mencantumkan waktu render per blok, jumlah pemanggilan, serta tahap transformasi, template, dan komponen. Pengukuran waktu yang sama dikirim sebagai header Server-Timing, yang tetap berfungsi saat CDN men-cache HTML.

Hanya pengguna yang sudah login dan memiliki edit_posts yang dapat melihat output, sementara permintaan lainnya menonaktifkan profiler di init. performance.measurement menambahkan header hash profil dan konfigurasi serta Performance_Measurement::snapshot() API.

blockstudio.json
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}

Satu sakelar untuk setelan bawaan produksi

Jika performance.profile diatur ke speed, keluaran generator, emoji, feed, dan penemuan di head dihapus, penemuan oEmbed dinonaktifkan, XML-RPC dan pingback dinonaktifkan, aset frontend inti generik dihapus, Heartbeat dibatasi di luar editor, dan tautan dari origin yang sama diprefetch saat diarahkan atau difokuskan.

Nilai bawaannya adalah compat, yang tidak mengubah apa pun. Setiap nilai turunan mengesampingkan profil, sehingga Anda dapat mempertahankan satu perilaku dan mengambil sisanya.

blockstudio.json
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

Gambar yang mempertahankan ruangnya

Gambar tema berada di luar pustaka media, jadi WordPress tidak mengetahui ukurannya. bs_media_image() membaca dimensi sebenarnya dari assets/media.json yang dihasilkan, lalu menyediakan ruang sesuai rasio aspek sebelum file dimuat.

Aktifkan performance.media.lazy agar URL yang sebenarnya menunggu di balik placeholder berukuran tepat hingga gambar mendekati area pandang.

index.php
<?php
echo bs_media_image([
  'src' => 'assets/images/hero.webp',
  'alt' => 'Hero',
  'eager' => true,
]);

Satu direktori cache

Setiap file yang dihasilkan berada di bawah cache.path, dengan kunci berupa identitas runtime.

Build single-flight

Satu permintaan membangun cache key yang masih kosong. Permintaan lain menunggu, menggunakan kembali payload terakhir yang valid, atau menerima 503 dengan Retry-After.

Payload yang ramah OPcache

Payload cache kecil berupa array PHP biasa yang dapat digunakan kembali oleh OPcache dari memori bersama. Payload yang lebih besar tetap dikompresi.

Cache render

Tag blok self-closing dengan atribut yang sama dirender sekali per permintaan. Pemanggilan berulang menggunakan data dari memori.

Pembaruan pilihan yang digabungkan

Serangkaian penulisan konten, seperti saat impor, digabung menjadi satu pembaruan pilihan field terisi yang di-cache.

Cache multi-tenant

Filter cache/site_key untuk batas tenant Anda sendiri dan cache/context untuk variasi runtime dari situs yang sama.

Aset terkompilasi di cache

Dengan assets.output diatur ke cache, aset terkompilasi dikeluarkan dari pohon blok, sehingga deploy dapat dilakukan dari checkout yang tak berubah.

Build yang dibagi menjadi shard

Static_Prerender_Batch_Renderer membagi build menjadi shard stabil berformat N/TOTAL, dan pemanggil dapat menghitung partisi yang sama.

Sematkan stylesheet kecil

assets.inlineLimit menyisipkan stylesheet blok terkecil secara inline sesuai batas ukuran byte, dengan urutan cascade yang sama.

Blok CSS terakhir di head

Blok CSS ditambahkan tepat sebelum tag penutup head, setelah stylesheet tema dan plugin.

Lewati aset yang tidak digunakan

Template yang tidak mengembalikan apa pun tidak akan memuat aset. assets.enqueue false menyerahkan semua aset kepada Anda.

Perintah cache

wp bs cache status, cleanup, dan clear memeriksa, mengosongkan, dan menghapus cache runtime. wp bs prerender purge menghapus halaman tersimpan.

Pembersihan menyeluruh

wp bs teardown hanya menghapus status yang dimiliki instalasi ini.

Hook hasil

cache/outcome dan static_prerender/outcome melaporkan hit, build, miss, dan kegagalan ke metrik Anda.

Hook error

error/logged dan error/exception meneruskan error Blockstudio ke logger atau pelacak eksternal.

Rendering batch

Batch_Render::reset() menghapus status permintaan di antara dokumen dalam satu proses. render/dependencies mencantumkan file untuk setiap blok.

Plus

Kit ekstensi resmi

Template situs premium, instruksi sistem AI, dan komunitas Discord privat. Pembelian satu kali, pembaruan seumur hidup.

  • 500+ templat situs
  • Instruksi sistem AI
  • Pembaruan seumur hidup
  • Komunitas privat Discord