İçeriğe geç

WordPress Hizmetini Statik HTML Olarak Sunma

Pazarlama veya dokümantasyon sitesindeki sayfaların çoğu, anonim ziyaretçiler için aynıdır. WordPress yine de her istekte başlatılır, tüm eklentileri yükler, temayı çalıştırır ve blokları oluşturur. Bir sayfa önbelleği eklentisi yardımcı olabilir, ancak kendi güvenli depolama kuralları olan yeni bir değişken daha ekler.

Blockstudio, isteğe bağlı statik ön oluşturma özelliğiyle gelir. Tam anonim HTML belgelerini kendi önbellek dizininde saklar ve izin verirseniz WordPress başlamadan önce bir advanced-cache.php eklentisinden sunar. Her şey blockstudio.json içinde yapılandırılır.

Bu kılavuz, özelliği adım adım etkinleştirir; nelerin önbelleğe alınıp alınmadığını nasıl denetleyeceğinizi gösterir, oturum açmış ziyaretçileri güvende tutan tek kuralı açıklar ve kaynağın önbelleğe alınabilir olarak işaretlediklerini önbelleğe alan bir CDN yapılandırmasıyla sona erer.

Bir istek nasıl sunulur

Ön oluşturma etkin olduğunda, uygun bir istek üç şekilde sonuçlanır:

  1. Erken önbellek isabeti. Eklenti, yol eşlemesinde kayıtlı bir belge bulur ve WordPress yüklenmeden önce belgeyi aktarır. Yanıt X-Blockstudio-Static-Prerender: HIT-EARLY bilgisini taşır.
  2. Önbellek isabeti. WordPress başlatılır ve template_redirect aşamasında Blockstudio güncel kayıtlı bir belge bulup şablonu oluşturmak yerine gönderir. Yanıt X-Blockstudio-Static-Prerender: HIT bilgisini taşır.
  3. Önbellek ıskası. WordPress sayfayı normal şekilde oluşturur. Ziyaretçi anonimse ve sonuç, durumu 200 olan eksiksiz bir HTML belgesiyse, Blockstudio belgeyi sonraki istek için saklar.

Uygun olmayan istekler önbelleğe hiç dokunmaz.

1. Adım: Profili ve önbelleği etkinleştirme

Performans profiliyle ve erken sunum kapalı olacak şekilde ön oluşturmayla başlayın:

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

Her bölümün yaptığı:

  • profile: "speed" üretim ön yüzü varsayılanlarını etkinleştirir: üstbilgi fazlalıkları, oEmbed keşfi, XML-RPC ve genel çekirdek ön yüz varlıkları kaldırılır; kullanıcı bir bağlantıya gitmek istediğinde aynı kaynaktaki bağlantılar önceden yüklenir. Çekirdek ön yüz varlıklarını kaldırma ayarını önce test edin; bunlara bağlı bir sayfa belirgin biçimde bozulur. Alt düzeydeki her değer profili geçersiz kılar.
  • staticPrerender.enabled çalışma zamanını kaydeder. false durumundayken özellik dosya yazmaz ve istek kancaları kaydetmez.
  • ttl, saklanan bir belgenin saniye cinsinden en uzun yaşını belirtir (varsayılan: 86400).
  • dynamicPaths, her zaman canlı olarak oluşturulması gereken yol öneklerini listeler.
  • warm, güncelliğini yitirmiş herkese açık URL’leri her interval saniyede yeniden oluşturan bir arka plan ısıtıcısı zamanlar.

$schema satırı tüm anahtarları kapsar; bu sayede JSON şema desteğine sahip bir düzenleyici, minimum değer 1 iken "ttl": 0 gibi bir hatayı işaretler.

2. Adım: Hangi isteklerin uygun olduğunu öğrenme

Blockstudio, sakladığı içerik konusunda temkinlidir. Şu istekler her zaman önbelleği atlar:

  • GET dışındaki her şey
  • Sorgu dizesi içeren her URL
  • wp-admin, wp-json, wp-login.php, xmlrpc.php, Ajax ve cron
  • Akışlar, arama ve önizleme yolları
  • X-WP-Nonce üstbilgisi gönderen istekler
  • dynamicPaths altındaki yollar
  • serveLoggedIn etkin değilse wordpress_logged_in_*, wp-postpass_* veya comment_author_email_* çerezine sahip ziyaretçiler

Dinamik yollar, yol sınırlarına göre eşleştirilir. Yukarıdaki yapılandırmayla:

İstek Atlandı
/pricing/ hayır
/account/orders/ evet
/accounting/ hayır
/checkout evet
/pricing/?utm_source=x evet
/blog/feed/ evet

Saklama tarafında yalnızca eksiksiz bir belge tutulur: yanıt <!doctype html veya <html ile başlamalı, durumu 200 olmalı ve vazgeçme işaretçisini içermemelidir. Hiçbir zaman saklanmaması gereken bir şablon, işaretçiyi sayfanın herhangi bir yerine yazdırabilir:

HTML
<!-- blockstudio:no-cache -->

Hata sayfaları hiçbir zaman saklanmaz; bu nedenle temalı bir 404 asla başarılı bir yanıt olarak yeniden sunulamaz.

3. Adım: Önbellek isabetlerini doğrulama

Gizli bir pencerede birkaç sayfayı ziyaret edin, ardından Blockstudio’e neleri tuttuğunu sorun:

Kabuk
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": []
}

Belgeler saklandıkça files ve bytes büyür; queue ısıtıcının bekleyen işlerini gösterir; diagnostics ise kapsam başına isabet, ıska, derleme ve hata sayaçlarını taşır. Tek bir sayfayı denetlemek için anonim ziyaretçi olarak sayfaya iki kez istek gönderin ve şu üstbilgiyi arayın:

Kabuk
curl -s -o /dev/null -D - https://example.com/pricing/ | grep -i x-blockstudio-static-prerender

İkinci yanıt X-Blockstudio-Static-Prerender: HIT bilgisini taşır. Yukarıdaki gibi bir GET kullanın: curl -I, önbelleği her zaman atlayan bir HEAD isteği gönderir.

4. Adım: WordPress Başlamadan Önce Sunma

Önbellek isabetleri doğru görünmeye başladığında "earlyServe": true ayarını yapın. Ardından Blockstudio üç küçük durum parçasını yönetir: bir wp-content/advanced-cache.php eklentisi, paylaşılan bir wp-content/blockstudio-static-prerender-map.php yol eşlemesi ve wp-config.php içinde bir WP_CACHE bildirimi. Bunlar sonraki yönetici isteğinde kurulur.

Paylaşımlı barındırma ve çoklu site kurulumlarında güvenliği korumaya yardımcı olan birkaç kural:

  • Blockstudio, kendisine ait olmayan bir drop-in’i, eşlemeyi veya WP_CACHE satırını asla değiştirmez. Başka bir önbellekleme eklentisi zaten advanced-cache.php sahibiyse erken sunum kapalı kalır.
  • WP_CACHE zaten true olarak tanımlanmışsa, wp-config.php olduğu gibi bırakılır. wp-config.php yazılamayan barındırma ortamlarında bunu kendiniz tanımlayın.
  • Sunumdan önce hem drop-in hem de PHP yolu, belgenin bağlantı verdiği içerik karmalı Tailwind stil sayfasının hâlâ var olduğunu denetler. Yoksa istek, stiller uygulanmadan sunulmak yerine WordPress adresine yönlendirilir.
  • Multisite kayıtları tek bir eşlemeyi paylaşır; ancak ana makine, ana yol ve site kimliğine göre birbirinden yalıtılır.
  • Varsayılan olarak Link olan replayHeaders içinde adı belirtilen yanıt başlıkları her belgeyle birlikte saklanır ve her önbellek erişiminde yeniden gönderilir. Böylece bir sayfanın header() ile gönderdiği Link başlığı erken sunum sırasında korunur. Çerez ve önbellekleme başlıkları asla yeniden gönderilmez.

Erken istekler X-Blockstudio-Static-Prerender: HIT-EARLY taşır. earlyServe veya enabled kapatıldığında, Blockstudio’ün sahip olduğu durum bir kez kaldırılır; wp bs teardown ise devre dışı bırakma kancası olmayan Composer kurulumlarında bunu açıkça kaldırır.

Oturum açmış ziyaretçiler ve aynı işaretleme

Varsayılan olarak oturum açmış ziyaretçiler her zaman canlı bir işleme alır. "serveLoggedIn": true ayarı, mevcut bir depolanmış belgeyi de kullanmalarını sağlar; böylece site, anonim ziyaretçiler kadar editörler ve müşteriler için de hızlı olur.

Kişiselleştirilmiş yanıtlar hiçbir zaman önbellek girdisi oluşturmaz: oturum açmış bir ziyaretçinin önbellek kaçırması canlı işlenir ve depolanmaz. Bunun gözden kaçırılması kolay bir sonucu vardır. serveLoggedIn açıkken, oturum açmış ziyaretçi varsa anonim belgeyi alır; yoksa kişiselleştirilmiş canlı bir işleme alır. Geçerli kullanıcıya göre şablon dalları yalnızca önbellek kaçırmalarında görünür; bu nedenle aynı sayfa ziyaretler arasında değişir ve önbelleğe alınan rotalardaki kişiselleştirilmiş dal fiilen hiç çalışmaz.

Bunun sonucu olan kural şudur: dynamicPaths dışındaki her rotada, oturum açmış kullanıcıların işaretlemesi anonim kullanıcıların işaretlemesiyle bayt düzeyinde aynı olmalıdır. Bu, statik rotalarda işlenen şablonlarda is_user_logged_in() veya wp_get_current_user() dallarının kullanılmaması demektir:

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

Bunu çözmenin iki temiz yolu var. Hesap kontrol paneli gibi sayfanın tamamının kişisel olduğu durumlarda rotayı dynamicPaths içine alın. Ya da sayfayı statik tutup kişisel kısmı dinamik bir blok adacığı olarak işleyin; bu adacık depolanmış HTML içinde önbelleğe uygun bir yer tutucu sunar ve gerçek parçayı ziyaretçinin kendi isteği sırasında getirir:

PHP
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>

Önbelleğe Alınan Sayfalarda Kişiselleştirilmiş Parçalar kılavuzu bu bloğun oluşturulmasını anlatır.

İmza veya grafik geçersizleştirme

invalidate, depolanan belgelerin nasıl süresinin dolacağını belirler.

Özellik signature (varsayılan) graph
Önbelleği kim doldurur anonim önbellek kaçırmaları ve ısıtıcı derleme adımınız ve anonim önbellek kaçırmaları
Girdilerin süresini ne doldurur TTL, yazı kayıtları, site düzeyindeki değişiklikler yeni bir derleme; TTL üst sınırdır
Arka plan ısıtıcısı kullanılabilir kapalı
Uygun olduğu siteler sıradan siteler dağıtım hattı olan siteler

signature modu araç gerektirmez. Bir yazıyı kaydetmek ana sayfanın ve o yazının kalıcı bağlantısının önbelleğini temizler veya yeniden ısıtır; tema değiştirmek gibi site düzeyindeki değişiklikler de önbellek kimliğini yeniler.

graph modu, öngörülebilir dağıtımlar içindir. Bir derleme Static_Prerender_Runtime::build_plan() ile bir plan hesaplar, yalnızca etkilenen URL’leri işler, her sonucu kaydeder ve biten kümeyi Static_Prerender_Early_Serve::install_artifact_entry() ile atomik olarak etkinleştirir. Başvurulan belgelerden herhangi birinin doğrulaması başarısız olursa önceki küme etkin kalır. Eşlenen rotalar, bir sonraki derleme bunların yerini alana kadar etkinleştirilmiş yapıt üzerinden sunulur; bu nedenle wp-admin’de düzenlenen içerik bu rotalara sonraki dağıtımla ulaşır. Yapıtlar tek bir birim olarak derlenip etkinleştirildiği için bu modda URL başına ısıtıcı kapalıdır. Tipik bir üretim düzeni şöyledir:

JSON
{
  "performance": {
    "profile": "speed",
    "staticPrerender": {
      "enabled": true,
      "invalidate": "graph",
      "ttl": 2592000,
      "earlyServe": true,
      "serveLoggedIn": true,
      "dynamicPaths": [
        "/account",
        "/cart",
        "/checkout",
        "/login",
        "/reset-password"
      ]
    }
  }
}

30 günlük ttl yalnızca sunulan bir belgenin ne kadar eski olabileceğini sınırlar. Güncellik, grafiği yeniden oluşturan dağıtımdan gelir. Derleme API, parçalama ve dahili işleme aktarımı, Statik Ön İşleme Referansı bölümünde ele alınır.

Önüne bir CDN koymak

Ön işleme, hangi yanıtların güvenle paylaşılabileceğini zaten bildirir: yalnızca HIT başlığını taşıyanlar. Kaynak sunucunun bunu bir önbellek başlığına dönüştürmesini sağlayın ve CDN, kaynak sunucunun ayarlarını izlesin. PHP-FPM önünde nginx kullanırken:

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

Düzenli ifade hem HIT hem de HIT-EARLY ile eşleşir. Diğer tüm yanıtlar için değişken boştur ve nginx boş değere sahip bir başlık eklemez; böylece önbellek kaçırmaları, dinamik yollar ve oturum açmış kullanıcıların işlemleri kaynak sunucudan paylaşılan önbellek süresi almadan çıkar.

CDN tarafında:

  • HTML’yi yalnızca kaynak sunucu bir önbellek süresi gönderdiğinde önbelleğe alın. Bu süre olmayan yanıtlar için varsayılan uç TTL’yi devre dışı bırakın.
  • Uç önbelleğini, Blockstudio’ün kişisel kabul ettiği çerezler (wordpress_logged_in_, wp-postpass_, comment_author_email_) ve dynamicPaths, wp-admin ile wp-json için devre dışı bırakın.
  • Sayfaları, şablonları veya varlıkları değiştiren her dağıtımdan sonra CDN’yi temizleyin. Kaynak sunucunun önbelleği kendiliğinden yenilenir; uç önbellek bunu bilmez.

Tailwind’ı "output": "link" ile kullanırsanız, URL stil sayfasının içerik karması alınır; bu nedenle bu yol uzun süreli, değişmez bir önbellek başlığıyla sunulabilir.

Bakım komutları

Kabuk
wp bs prerender warm
wp bs prerender status
wp bs prerender purge
wp bs teardown

warm eski herkese açık URL’leri kuyruğa ekler ve her çalıştırmada bunlardan en fazla warm.concurrency tanesini işler; ayrıca bir JSON özeti yazdırır. purge geçerli sitenin depolanmış belgelerini ve kuyruğunu kaldırır. teardown bu kurulumun sahip olduğu cron olaylarını ve erken sunum durumunu kaldırır, yapılandırma dosyalarını olduğu gibi bırakır.

Şu sırayla devreye alın: önce profili, sonra earlyServe kapalıyken ön işlemeyi, ardından status ve başlıklar doğru görünüyorsa erken sunumu. Her katman, değerini geri alarak kendi başına geri alınabilir.

Sonraki adımlar