# Mümkün olduğunda statik

blockstudio.json içinde ayarlanan, önceden oluşturulmuş sayfalar ve üretim varsayılanları.

## Anonim sayfaları önceden oluşturun

Statik önceden oluşturma varsayılan olarak kapalıdır. `performance.staticPrerender` ayarını açtığınızda Blockstudio, anonim bir ziyaretçiye sunulan her eksiksiz HTML belgesini saklar; sonraki anonim ziyaretçiye de bu kopyayı sunar.

Canlı kalması gereken istekler önbelleğe hiç dokunmaz: GET dışındaki istekler, sorgu dizeleri, yönetici alanı, REST, Ajax, cron, akışlar, arama, önizlemeler, nonce içeren sayfalar, `dynamicPaths` altındaki tüm yollar ve `serveLoggedIn` açıksa oturum açmış ziyaretçiler.

[Statik ön oluşturma](https://blockstudio.dev/tr/docs/production/static-prerendering/)

blockstudio.json

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

## Varsayılan olarak kapalı

blockstudio.json bu özelliği adlandırana kadar hiçbir şey değişmez.

## Dinamik yollar

/account için tanımlanan dinamik bir yol /account/orders yolunu kapsar, ancak /accounting yolunu kapsamaz.

## Devre dışı bırakma işareti

Bir blockstudio:no-cache yorumu, tüm yanıtların önbelleğe alınmasını engeller.

## Oturum açmış ziyaretçiler

serveLoggedIn ile kayıtlı sayfaları görürler; kendi sayfaları asla kaydedilmez.

## [Özel atlama](https://blockstudio.dev/tr/docs/blocks/hooks/php/#blockstudio-static_prerender-request_bypass)

static_prerender/request_bypass filtresi, örneğin sepet çerezi taşıyanlar gibi belirttiğiniz isteklerin kayıtlı sayfalara erişmesini engeller.

## Ön ısıtma kuyruğu

Kalıcı bir kuyruk, eski sayfaları belirlediğiniz aralıklarla yeniden işler.

## [Uzun kuyruklu rotalar](https://blockstudio.dev/tr/docs/production/static-prerendering/#early-serving-and-atomic-deployment)

Dağıtılan haritanın dışındaki rotalar da WordPress tarafından oluşturulup kaydedildikten sonra erken sunulur.

## Stil sayfası denetimi

Bağlantı verilen Tailwind stil sayfası silinmişse kayıtlı sayfa biçimlendirmesiz sunulmaz, yeniden oluşturulur.

## WordPress başlatılmadan önce sunulur

`earlyServe` açıkken Blockstudio, saklanan bir sayfayı WordPress, eklentiler veya tema yüklenmeden önce akış olarak sunan bir `advanced-cache.php` drop-in yükler. Yazmadığı bir drop-in dosyasının, rota eşlemesinin veya `WP_CACHE` satırının üzerine asla yazmaz.

Bu site bunu çalıştırıyor. 8 Ekim’de 2026, blockstudio.dev sayfaları, drop-in’in gönderdiği başlık olan `x-blockstudio-static-prerender: HIT-EARLY` ile yanıt verdi.

[Erken sunum](https://blockstudio.dev/tr/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
```

## Her değişiklikten sonra güncel

Varsayılan `signature` modu, anonim bir önbellek kaçırmasında önbelleği doldurur ve site düzeyindeki değişikliklerden sonra yeniler. Bir yazıyı kaydetmek veya silmek, o yazının ve ön sayfanın önbelleğini temizler ya da ön ısıtma açıksa yeniden oluşturulmaları için kuyruğa alır.

`graph` modu dağıtım araçları içindir. Her sayfanın okuduğu dosyaları kaydeder; böylece derleme yalnızca dosyaları değişen rotaları yeniden işler ve yeni kümeyi tek bir yapıt olarak etkinleştirir. Başvurulan bir dosya doğrulamadan geçemezse önceki yapıt yayında kalır.

Bir yapıt yüklenirken baytlar karşılaştırılır ve değişen belgeler atomik olarak değiştirilir. `last_promotion()`; yükseltilen, değiştirilen, atlanan veya korunan rota sayısını bildirir. Böylece dağıtım bunu günlüğe kaydedip etkin derleme kimliğiyle karşılaştırabilir.

[İmza ve grafik modları](https://blockstudio.dev/tr/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']));
```

## Bir CDN arkasında

Önceden oluşturma başlığı, hangi yanıtların güvenle paylaşılabileceğini zaten belirtir. `HIT` ve `HIT-EARLY` değerlerini kaynak sunucuda `Cache-Control` süreye eşleyin; yalnızca bu süreyi taşıyanları önbelleğe alın ve `wordpress_logged_in_`, `wp-postpass_` ve `comment_author_email_` çerezleri, sizin `dynamicPaths`, `wp-admin` ve `wp-json` için uç katmanı devre dışı bırakın.

Uçta önbelleğe alınan sayfalar, oluşturuldukları içerik özetiyle adlandırılmış stil sayfasına bağlantı vermeyi sürdürür. `cache.namespaceGrace` değerini bu kopyanın yaşayabileceği en uzun süreye yükseltin; kullanım dışı kalan stil sayfaları da süre dolana kadar diskte tutulur.

[CDN kurulumu](https://blockstudio.dev/tr/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;
}
```

## Önbelleğe alınmış bir sayfada tek bir canlı blok

`blockstudio.island` değerini `dynamic` olarak ayarlayın; önbelleğe alınmış sayfada blok yerine bir yer tutucu bulunur. Tarayıcı, sayfadaki tüm dinamik adacıkları toplar ve her biri blok adı ile izin verilen öznitelikleriyle imzalanmış parçaları tek bir toplu istekte getirir.

`hydrate`, tam HTML değerini sayfada tutar ve yalnızca bir bağlama olayı gönderir. Dinamik adacıklar görünür olana kadar bekleyebilir, bir pencere olayı tetiklendiğinde yenilenebilir ve parçaları kullanıcıya özel ya da genel olarak önbelleğe alabilir.

[Blok adacıkları](https://blockstudio.dev/tr/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"
      }
    }
  }
}
```

## Oluşturma süresinin nereye gittiğini görün

Herhangi bir ön yüz URL öğesine `?blockstudio-perf` ekleyin; bir panel blok başına oluşturma sürelerini, çağrı sayılarını ve dönüştürme, şablon ve bileşen aşamalarını listeler. Aynı süreler `Server-Timing` başlıkları olarak da gönderilir; böylece bir CDN HTML önbelleğe aldığında da çalışmaya devam eder.

Çıktıyı yalnızca `edit_posts` iznine sahip oturum açmış kullanıcılar görür; diğer tüm isteklerde profil oluşturucu `init` aşamasında kapatılır. `performance.measurement`, profil ve yapılandırma özeti başlıklarıyla bir `Performance_Measurement::snapshot()` API ekler.

[Profil oluşturucu](https://blockstudio.dev/tr/docs/production/performance/#profiler)

blockstudio.json

```
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}
```

## Üretim varsayılanlarını tek anahtarla ayarlayın

`performance.profile`, `speed` olarak ayarlandığında üst bilgideki oluşturucu, emoji, akış ve keşif çıktılarını kaldırır; oEmbed keşfini düşürür; XML-RPC ve geri izleme bildirimlerini devre dışı bırakır; çekirdeğin genel ön yüz varlıklarını kaldırır; düzenleyiciler dışındaki Heartbeat sıklığını düşürür ve fareyle üzerine gelindiğinde veya odaklanıldığında aynı kaynaklı bağlantıları önceden getirir.

Varsayılan değer, hiçbir şeyi değiştirmeyen `compat` değeridir. Her alt değer profili geçersiz kılar; böylece geri kalanını kullanırken tek bir davranışı koruyabilirsiniz.

[Performans profilleri](https://blockstudio.dev/tr/docs/production/performance/#performance-profiles)

blockstudio.json

```
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}
```

## Boşluğunu koruyan görseller

Tema görselleri medya kütüphanesinin dışında bulunur, bu nedenle WordPress boyutları hakkında bilgi sahibi değildir. `bs_media_image()`, oluşturulan bir `assets/media.json` dosyasından gerçek boyutları okur ve dosya yüklenmeden önce en-boy oranı için yer ayırır.

`performance.media.lazy` özelliğini açın; gerçek URL, görsel görüntü alanına yaklaşana kadar doğru boyutlandırılmış bir yer tutucunun arkasında bekler.

[Medya](https://blockstudio.dev/tr/docs/production/media/)

index.php

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

## [Tek önbellek dizini](https://blockstudio.dev/tr/docs/production/caching/)

Oluşturulan her dosya, çalışma zamanı kimliğine göre anahtarlanan cache.path altında bulunur.

## [Tek seferlik derlemeler](https://blockstudio.dev/tr/docs/production/caching/#concurrency-and-retention)

Bir istek, soğuk bir önbellek anahtarı için derleme yapar. Diğerleri bekler, son geçerli yükü yeniden kullanır veya Retry-After içeren bir 503 alır.

## OPcache dostu yükler

Küçük önbellek yükleri, OPcache’in paylaşılan bellekten yeniden kullanabildiği düz PHP dizileridir. Daha büyük olanlar sıkıştırılmış kalır.

## [Oluşturma önbelleği](https://blockstudio.dev/tr/docs/production/performance/#render-cache)

Aynı özniteliklere sahip, kendi kendini kapatan bir blok etiketi istek başına bir kez oluşturulur. Tekrarlar bellekten gelir.

## Birleştirilmiş seçenek yenileme

İçe aktarma gibi yoğun bir içerik yazma grubu, önbelleğe alınan doldurulmuş alan seçenekleri için tek bir yenilemeye dönüşür.

## Çok kiracılı önbellekler

Kendi kiracı sınırınız için cache/site_key filtresini, aynı sitenin çalışma zamanı varyantları için cache/context filtresini kullanın.

## [Önbellekte derlenmiş varlıklar](https://blockstudio.dev/tr/docs/general/settings/#assets)

assets.output değeri cache olarak ayarlandığında, derlenmiş varlıklar blok ağacından çıkar; böylece dağıtım değişmez bir çalışma kopyasından yapılır.

## Parçalı derlemeler

Static_Prerender_Batch_Renderer bir derlemeyi kararlı N/TOTAL parçalarına böler; çağıran taraf da aynı bölümü hesaplayabilir.

## [Küçük stil sayfalarını satır içine alın](https://blockstudio.dev/tr/docs/blocks/assets/registering/#inline-small-stylesheets)

assets.inlineLimit, en küçük blok stil sayfalarını bayt sınırı içinde ve aynı basamaklandırma sırasıyla satır içine yazar.

## [Blok CSS öğesini head bölümünde sona alın](https://blockstudio.dev/tr/docs/blocks/assets/registering/#load-order)

Blok CSS, tema ve eklenti stil sayfalarından sonra, kapanış head etiketinin hemen önüne eklenir.

## [Kullanılmayan varlıkları atlayın](https://blockstudio.dev/tr/docs/blocks/assets/registering/#disable-enqueuing)

Hiçbir şey döndürmeyen bir şablon hiçbir varlığı kuyruğa eklemez. assets.enqueue false ise tüm varlıkların yönetimi size bırakılır.

## [Önbellek komutları](https://blockstudio.dev/tr/docs/dev/cli/)

wp bs cache status, cleanup ve clear çalışma zamanı önbelleğini inceler, boşaltır ve temizler. wp bs prerender purge ise kayıtlı sayfaları siler.

## Temiz kaldırma

wp bs teardown yalnızca bu kurulumun sahip olduğu durumu kaldırır.

## Sonuç kancaları

cache/outcome ve static_prerender/outcome raporları isabetleri, derlemeleri, önbellek kaçırmalarını ve hataları metriklerinize iletir.

## [Hata kancaları](https://blockstudio.dev/tr/docs/blocks/hooks/php/#error-handling)

error/logged ve error/exception, Blockstudio hatalarını harici bir günlük kaydediciye veya izleyiciye iletir.

## [Toplu işleme](https://blockstudio.dev/tr/docs/production/performance/#in-process-batch-rendering)

Batch_Render::reset(), tek bir süreçteki belgeler arasında istek durumunu temizler. render/dependencies her bloğun dosyalarını listeler.

Plus

## Resmî uzantı kiti

Premium site şablonları, yapay zekâ sistem talimatları ve özel bir Discord topluluğu. Tek seferlik satın alma, ömür boyu güncellemeler.

- 500+ site şablonu
- Yapay zekâ sistem talimatları
- Ömür boyu güncellemeler
- Özel Discord topluluğu

[Plus edinin](https://blockstudio.dev/tr/plus/)
