İçeriğe geç

Statik Ön Oluşturma

Statik ön oluşturma, isteğe bağlı bir anonim HTML önbelleğidir. Önbelleğe alınabilir bir yanıtın eksiksiz bir HTML belgesi olması gerekir ve <!-- blockstudio:no-cache --> ile önbellek dışı bırakılabilir. Blockstudio; GET dışındaki istekleri, sorgu dizelerini, WordPress yönetimini, REST, Ajax’ı, cron, beslemeleri, sitenin ana yolundaki arama tabanının altındaki arama sonuçlarını (örneğin /search/term/), önizleme ve tuval üstbilgilerini, nonce içeren istekleri, tanımlı dinamik yolları, parola/yorum çerezlerini ve varsayılan olarak oturum açmış istekleri atlar. Yolunda daha aşağıda yalnızca bir search veya preview bölümü bulunan bir sayfa (örneğin /docs/blocks/preview/) diğer sayfalar gibi önbelleğe alınır.

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

Oturum açmış kullanıcılar mevcut bir isabeti yalnızca serveLoggedIn true olduğunda kullanabilir; kişiselleştirilmiş yanıtlar hiçbir zaman önbellek girdisi oluşturmaz. Dinamik yollar yol sınırlarını kullanır; bu nedenle /account, /account/orders ile eşleşir ancak /accounting ile eşleşmez.

Özellik devre dışıyken hiçbir dosya yazmaz, geçici eklenti kurmaz ve hiçbir istek veya yönetim kancası kaydetmez. earlyServe: false de Erken Sunum yönetim geri çağrısı kaydetmez; warm.enabled: false ise hiçbir cron geri çağrısı veya zamanlama kaydetmez. Her iki özellikten biri kapatıldığında, daha önce sahip olduğu durum bir kez kaldırılır; sonraki isteklerde dosya sistemi veya cron temizleme denetimleri yapılmaz.

Ortama göre kapatma

Yukarıdaki her değer bir ayar filtresiyle de belirlenebilir. Blockstudio etkin temadan önce, bir eklentiden veya temanın Composer otomatik yüklemesinden başlatılır; bu nedenle tema yüklendikten sonra çalışma zamanı ayarlarını yeniden çözümler ve statik ön oluşturma kancalarını after_setup_theme aşamasında belirler. Dolayısıyla bir eklentide veya temanın functions.php dosyasında eklenen bir filtre etkili olur:

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

Özelliği bu şekilde kapatmak, blockstudio.json içinde kapatmakla aynı şekilde çalışır: hiçbir istek, içerik, yönetim veya cron kancası kaydedilmez ve daha önce erken sunulmuş bir sitenin Erken Sunum girdisi bir kez kaldırılır. Örneğin init üzerinde daha sonra eklenen bir filtre, hangi kancaların kaydedildiğini değiştirmez.

İmza ve grafik modları

signature modu, normal bir anonim önbellek kaçırmasında kimlik anahtarlı bir yanıtı doldurur. Standart WordPress siteleri için kullanışlıdır ve site düzeyindeki değişikliklerden sonra yenilenir.

graph modu, deterministik derleme/dağıtım entegrasyonları içindir. Canlı kaynak URL’lerini Static_Prerender_Runtime::build_plan() ile çağırın, yalnızca affectedUrls öğelerini render edin, ardından her sonucu persist_built_response() veya persist_skipped_response() ile kaydedin. Plan, paylaşılan dosyaları ve her sayfanın tam bağımlılık karmalarını karşılaştırır. Silinen URL’ler ve başvurulmayan HTML öğeleri garbage_collect() tarafından kaldırılır.

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

İsteğe bağlı hedef ana makine/ana sayfa bağımsız değişkenleri, ilk sayfanın yolunu site kökü olarak kullanmadan dağıtım rotalarını yeniden yazar. Toplu işlem araçları Static_Prerender_Batch_Renderer::render() ve kararlı N/TOTAL parçalarını kullanabilir; parçalama seçeneğinin arkasında Static_Prerender_Batch_Renderer::parse_shard() ve select_shard() bulunur, böylece çağıran taraf oluşturucunun kullanacağı bölümü hesaplayabilir. Derleme sırasında Static_Prerender_Batch_Renderer::is_rendering(), mevcut isteğin bir ziyaretçiden değil toplu render işleminden gelip gelmediğini bildirir; böylece şablon, derleme sırasında çalışmaması gereken işleri atlayabilir. internal aktarımı genel blockstudio/static_prerender/render_internal filtresiyle sağlanır; isteğe bağlı HTTP geri dönüşü normal ısıtma üstbilgisini kullanır.

Grafik modu neleri izler

Varsayılan HTTP aktarımında Static_Prerender_Batch_Renderer::render(), her ısıtma isteğine imzalı bir belirteç gönderir ve istek okuduğu dosyaları bildirir: şablonun yüklediği WordPress, render edilen her Blockstudio bloğunun şablonu, şablon dosyaları ve varlık dosyaları, blockstudio/render/dependencies aracılığıyla eklenen dosyalar ve senkronize edilmiş bir sayfanın tanım, şablon, içerik ve düzen dosyaları. Rapor, oluşturucunun ve web sunucusunun render edilmiş HTML için zaten paylaştığı sitenin önbellek dizinine yazılır. Sonraki derlemede build_plan() bu dosyaları yeniden karmalar ve yalnızca dosyaları değişen rotaları, yeni rotaları, ttl süresi dolmuş rotaları ve paylaşılan bir dosya değiştiğinde tüm rotaları işaretler (blockstudio.json, theme.json, style.css, functions.php, header.php, footer.php, inc/ altındaki her şey, parts/ ve Blockstudio tarafından paketlenen UI varlıklarının kaynakları olan templates/). Paylaşılan imza, derlenmiş çıktıyı değil kaynakları karmalar; bu nedenle ilk render sırasında derlemenin oluşturduğu _dist dosyaları imzayı değiştirmez: artifact_entry(), derlemeden önce build_plan() tarafından görülen imzadan derleme kimliğini türetir.

Yalnızca veritabanında bulunan içerik dosya değildir ve izlenmez: yönetim panelinde düzenlenen yazılar, seçenekler, oluşturulan satırlar veya fiyatlar. Bu tür değişikliklerin derlemeye yansıması gerekiyorsa derleme $force değerini build_plan() öğesine iletir veya etkilenen URL’leri kendisi render eder. internal aktarımı, filtresinin döndürdüğü bağımlılıkları kaydeder.

Erken sunum ve atomik dağıtım

earlyServe etkinleştirildiğinde Blockstudio küçük bir wp-content/blockstudio-static-prerender-map.php, bir advanced-cache.php geçici eklentisi ve tam olarak bir WP_CACHE bildiriminin sahibi olur. Geçici eklenti, site başına rota eşlemesini okur ve uygun bir isabeti WordPress, eklentiler veya tema başlatılmadan önce akış olarak sunar.

Blockstudio hiçbir zaman başka birine ait eşlemeyi, geçici eklentiyi veya WP_CACHE bildirimini üzerine yazmaz. Grafik yapıtları eşleme değiştirilmeden önce başvurulan her HTML dosyasını doğrular; doğrulama başarısız olursa önceki grafik etkin kalır. Çoklu site girdileri eşlemeyi paylaşır, ancak ana makine, ana yol ve site kimliğine göre birbirinden yalıtılır. Özellik devre dışı bırakıldığında veya Blockstudio etkisizleştirildiğinde yalnızca geçerli sitenin girdisi kaldırılır; paylaşılan yapıtlar ise yalnızca sahip olunan son girdi de kaldırıldıktan sonra silinir.

Dağıtım araçları, tamamen render edilmiş bir grafiği atomik olarak etkinleştirebilir:

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

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

Yapılandırma her zaman belirleyicidir. Hem enabled hem de earlyServe true olmadıkça install_artifact_entry(), false değerini döndürür; böylece dağıtım, sonraki yönetim isteğinin yeniden kaldıracağı bir eşleme, geçici eklenti ve WP_CACHE bildirimi kuramaz.

install_artifact_entry(), girdinin build_id değerini korur; böylece dağıtım, bunu sonrasında installed_map_entries() tarafından döndürülen girdiyle karşılaştırabilir. Eşleme, include ile okunan bir PHP dosyasıdır ve her yazma işlemi dosyayı opcode önbelleğinden çıkarır; böylece opcache.enable_cli etkin olsa bile aynı süreçte yapılan okuma yeni girdiyi görür.

Bir yapıtın kurulması, belgelerini saklama temizliğinin dokunmadığı özel bir yapıt kapsamına taşır. Eşlemenin başvurduğu dosyalar, nerede bulunurlarsa bulunsunlar, silinmeye karşı korunur; böylece canlı render trafiği, eşlenmiş rotaların erken sunumdan düşmesine neden olamaz. Rota anahtarı içeriğin tamamını temel almaz; bu nedenle yeniden render, anahtarını değiştirmeden bir belgeyi değiştirebilir. Kurulum sırasında baytlar karşılaştırılır ve farklı yapıt belgeleri atomik olarak değiştirilir; aynı belgeler olduğu gibi bırakılır ve depodaki kopyası kaybolmuş bir yapıt belgesi korunur. Static_Prerender_Early_Serve::last_promotion(), son kurulumda kaç rotanın taşındığını, değiştirildiğini, atlandığını veya korunduğunu bildirir; böylece dağıtım bunu günlüğe kaydedebilir.

Kaydedilmiş bir belge, URL ile bağlantı verdiği derleme varlıklarını sabitler; bu dosyaların saklama süreleri ayrıdır, dolayısıyla biri diğerinden daha uzun süre kalabilir. Sunumdan önce hem PHP önbelleği hem de geçici eklenti, içerik karmalı bağlantılı Tailwind stil dosyasının diskte hâlâ bulunduğunu denetler. Stil dosyası kaybolmuş bir belge, stilsiz sunulmak yerine WordPress öğesine iletilir; bu da stil dosyasını ve belgeyi birlikte yeniden yayımlar. Aynı denetim yanıt kaydedilmeden önce de yapılır; böylece sunulamayan bir belge hiçbir zaman yazılmaz.

Accept üstbilgisi text/markdown içeren bir istek, hem PHP deposunu hem de geçici eklentiyi atlar; çünkü kaydedilen belgeler HTML şeklindedir ve bir sayfa bu isteğe kendi kaynağı Markdown ile yanıt verebilir. Bu nedenle sunulan belgeler Vary: Accept gönderir. Blockstudio güncellendiğinde, sonraki eşleme yazımında eski bir geçici eklenti yeniden yazılır.

Eşlenmiş grafik rotaları her zaman etkinleştirilmiş yapıtı kullanır. Güvenli bir anonim rota eşlemede yoksa ancak WordPress bu rotayı daha sonra render edip kaydetmişse, Erken Sunum WordPress başlatılmadan önce kimlik anahtarlı çalışma zamanı deposuna geri döner. Bu, kasıtlı olarak sınırlandırılmış bir dağıtım grafiğinin dışındaki oluşturulmuş veya nadiren ziyaret edilen rotaları destekler. Geri dönüş, etkinleştirilmiş grafik kimliğini ve eşlenmiş rotalarla aynı ana makine, yol normalleştirme, TTL, çerez, üstbilgi, sorgu dizisi, dinamik yol ve besleme atlama kurallarını kullanır; yalnızca çalışma zamanı tarafından kaydedilmiş belgeleri bulur ve bu belgeler hiçbir zaman arama sonuçlarını içermez.

Yanıt başlıkları

Saklanan bir belge, onu oluşturan istek olmadan yeniden sunulur; bu nedenle temanın veya eklentinin header() ile gönderdiği bir başlık her önbellek erişiminde eksik kalır. Blockstudio, replayHeaders içinde adı belirtilen başlıkları her belgeyle birlikte saklar ve bunları hem PHP önbelleğinden hem de erken sunum drop-in bileşeninden yeniden gönderir. Varsayılan ["Link"]; Markdown alternatifi (rel="alternate"; type="text/markdown"), rel="describedby" veya rel="canonical" gibi başlıkları kapsar. Adlar büyük/küçük harfe duyarsız eşleşir ve ayar filtresi, listeyi diğer değerlerde olduğu gibi değiştirir:

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

    return $headers;
});

Başlıkların yeniden gönderilmesini devre dışı bırakmak için replayHeaders değerini [] olarak ayarlayın. Açıkça belirtilen bir liste varsayılanın yerini alır; bu nedenle bağlantı başlıklarının yeniden gönderilmesini istiyorsanız başka başlık adları eklerken Link öğesini de ekleyin.

Başlıklar, sayfayı oluşturan süreçte yakalanır: canlı bir önbellek kaçırması saklandığında headers_list() üzerinden, bir derleme veya ısıtıcı HTTP üzerinden oluşturduğunda ise doğrudan ısıtma isteğinden alınır. Bu nedenle web sunucusunun kendi başına eklediği ve sunulan her belgeye yeniden eklediği bir başlık hiçbir zaman saklanmaz. Yalnızca bir HTTP oluşturma işlemi rapor yazmadığında yanıtın başlıkları kullanılır. internal aktarımı bunları sonucunda headers olarak döndürür; persist_built_response() ise son bağımsız değişken olarak, Name: value satırları veya ad-değer eşlemesi biçiminde alır.

Bunlar belgenin yanındaki <key>.headers.json konumuna yazılır, yapıtın yükseltilmesi, çöp toplama ve saklama süresi temizliği boyunca belgeyle birlikte taşınır ve yeniden oluşturma sırasında hiçbiri gönderilmezse kaldırılır. Çerez, önbellekleme ve aktarım başlıkları listede olsalar bile hiçbir zaman saklanmaz veya yeniden gönderilmez: Set-Cookie, Cache-Control, Expires, Pragma, Age, ETag, Last-Modified, Vary, Content-Type, Content-Length, Content-Encoding, Transfer-Encoding, Location, Status, Date ve hop-by-hop ile kimlik doğrulama başlıkları. Sunulan bir belge kendi Content-Type ve Vary değerlerini ayarlar.

Saklanan başlıklar gönderilirken listeye göre yeniden denetlenir. PHP önbelleği geçerli ayarı okur; drop-in ise sitenin eşleme kaydındaki kopyayı okur ve bu kopya bir sonraki yapıt kurulumu veya eşleme eşitlemesi sırasında yenilenir. Yükseltmeden önce saklanan belgelerde başlık dosyası bulunmaz ve yeniden oluşturulana kadar her zamanki gibi sunulurlar.

Isıtma, bakım ve gözlemlenebilirlik

Isıtma kuyruğu kalıcıdır, URL birleştirme uygular, aynı anda tek iş çalıştırır ve zaman aşımına uğramış talepleri kurtarır. İçerik ve site değişiklikleri, mevcut imza değişmemiş olsa bile yeni bir işi zorunlu kılar; aralıklarla yapılan geçişler yalnızca güncel olmayan işleri kuyruğa alır. Zamanlanmış veya wp bs prerender warm aracılığıyla yapılan her geçişte en fazla warm.concurrency iş render edilir. graph modu, grafik yapıtları tek bir birim olarak derlenip etkinleştirildiği için URL başına ısıtıcıyı kapatır.

Kabuk
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 etkin kimliği, dosyaları, baytları, grafik kayıtlarını, kuyruk durumunu, erken sunum eşlemesi raporunu ve kapsam başına isabet/kaçırma/derleme/hata sayaçlarını bildirir.

Erken sunum eşlemesi, bir kurulumdaki tüm siteler tarafından paylaşılır. map status (ve Static_Prerender_Early_Serve::map_report()), erken sunumun artık kullanamayacağı girdileri listeler: artık var olmayan sitelere ait orphaned girdileri, dizini silinmiş dead girdileri ve kalan girdilerdeki missing rota belgesi sayısı. map prune (Static_Prerender_Early_Serve::prune_map()), harita kilidini kullanarak sahipsiz ve kullanılamaz girdileri kaldırır ve her birini nedeni ile bildirir; --dry-run ise yalnızca raporlar. Son girdi kaldırıldığında eşleme, geçici eklenti ve WP_CACHE bildirimi de kaldırılır. Çoklu site ağından bir site silindiğinde girdileri hemen kaldırılır. Önbellek temizliği, etkinleştirilmiş yapıtın sunulduğu ad alanını hiçbir zaman toplamadığından girdiler ancak dosyaları başka yollarla silinirse kullanılamaz hâle gelir.

Tek tek yanıt sonuçlarını blockstudio/static_prerender/outcome ile, tüm paylaşılan önbellek sonuçlarını blockstudio/cache/outcome ile izleyin.

Kaldırma

Composer ile birlikte gelen kurulumlar gibi eklenti etkisizleştirme kancası olmayan kurulumlar, özelliğin sahip olduğu her şeyi tek bir komutla kaldırabilir:

Kabuk
wp bs teardown

Kurulumun sahip olduğu cron olaylarını ve statik ön oluşturma durumunu kaldırır: geçerli sitenin eşleme girdisini ve sahip olunan son girdi de kaldırıldığında paylaşılan geçici eklentiyi ve WP_CACHE bildirimini. Yapılandırma dosyaları olduğu gibi bırakılır; böylece özellik yeniden etkinleştirildiğinde temiz bir başlangıç yapılır.

Üretimde kullanıma alma

Uygulamaya başlamak için makul bir sıra:

  1. performance.profile değerini speed olarak ayarlayın; ardından head çıktısını, beslemeleri ve oEmbed’e veya XML-RPC özelliğine bağlı eklentileri denetleyin.
  2. assets/media.json oluşturun, şablonları bs_media_image() konumuna taşıyın ve ardından performance.media.lazy özelliğini açın.
  3. earlyServe kapalıyken performance.staticPrerender özelliğini etkinleştirin, isabetleri wp bs prerender status ile doğrulayın ve ardından earlyServe özelliğini açın.

Geri alma, her özellik için ayrı yapılır: staticPrerender.enabled değerini false olarak ayarlamak, Blockstudio tarafından sahip olunan Erken Sunum durumunu ve ısıtma zamanlamalarını bir kez kaldırır, ardından ön oluşturma çalışma zamanını kayıtsız bırakır. performance.profile değerini yeniden compat olarak ayarlamak profili geri alır. Her işlem diğer katmanları yerinde bırakır.

Performans

Profiller, profil oluşturucu ve temel render teknikleri.

Önbelleğe Alma

Oluşturulan her yapıtın bulunduğu tek önbellek dizini.