# 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.

[Prarender statis](https://blockstudio.dev/id/docs/production/static-prerendering/)

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](https://blockstudio.dev/id/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

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](https://blockstudio.dev/id/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

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.

[Penyajian lebih awal](https://blockstudio.dev/id/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

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.

[Mode tanda tangan dan grafik](https://blockstudio.dev/id/docs/production/static-prerendering/#signature-and-graph-modes)

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.

[Penyiapan CDN](https://blockstudio.dev/id/guides/static-prerendering/#putting-a-cdn-in-front)

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.

[Blok pulau](https://blockstudio.dev/id/docs/blocks/islands/)

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.

[Profiler](https://blockstudio.dev/id/docs/production/performance/#profiler)

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.

[Profil performa](https://blockstudio.dev/id/docs/production/performance/#performance-profiles)

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.

[Media](https://blockstudio.dev/id/docs/production/media/)

index.php

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

## [Satu direktori cache](https://blockstudio.dev/id/docs/production/caching/)

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

## [Build single-flight](https://blockstudio.dev/id/docs/production/caching/#concurrency-and-retention)

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](https://blockstudio.dev/id/docs/production/performance/#render-cache)

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](https://blockstudio.dev/id/docs/general/settings/#assets)

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](https://blockstudio.dev/id/docs/blocks/assets/registering/#inline-small-stylesheets)

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

## [Blok CSS terakhir di head](https://blockstudio.dev/id/docs/blocks/assets/registering/#load-order)

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

## [Lewati aset yang tidak digunakan](https://blockstudio.dev/id/docs/blocks/assets/registering/#disable-enqueuing)

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

## [Perintah cache](https://blockstudio.dev/id/docs/dev/cli/)

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](https://blockstudio.dev/id/docs/blocks/hooks/php/#error-handling)

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

## [Rendering batch](https://blockstudio.dev/id/docs/production/performance/#in-process-batch-rendering)

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

[Dapatkan Plus](https://blockstudio.dev/id/plus/)
