React Uygulamaları için Kenar Önbellekleme Stratejileri

Cache-Control yanıt üst bilgisi, Cloudflare'ın (ve diğer CDN'lerin) SSR yanıtlarınızı ne kadar süreyle önbelleğe alacağını denetler. Temel yönergeler şunlardır: max-age (tarayıcı önbelleği), s-maxage (CDN/paylaşılan önbellek süresi) ve stale-while-revalidate (arka planda yeniden doğrulama yapılırken eski içeriği sunma).

s-maxage, paylaşılan önbellekler (CDN'ler) tarafından dikkate alınırken max-age tarayıcı önbellekleri içindir. SSR sayfaları için genellikle s-maxage=60 (CDN 60 saniye boyunca önbelleğe alır) ve max-age=0 (tarayıcı her zaman yeniden doğrular) kullanmak istersiniz; böylece tüm kullanıcılar uç önbellekten makul ölçüde güncel içerik alır.

Cache-Control üst bilginize stale-while-revalidate=30 eklemek, Cloudflare'a önbelleğe alınmış sayfayı hemen sunarken arka planda güncel bir sürümü almasını söyler. Kullanıcılar her zaman hızlı bir yanıt alır; en fazla eskime süresi s-maxage + stale-while-revalidate saniyedir.

Kişiselleştirilmiş içerik (kullanıcı oturumuna veya yerel ayara dayalı) paylaşılan bir önbellekten yanlış kullanıcıya sunulmamalıdır. Vary: Cookie üst bilgisi, Cloudflare'a her benzersiz Cookie değerini ayrı bir önbellek girdisi olarak ele almasını söyler ve bir kullanıcının verilerinin başka bir kullanıcıya sunulmasını önler.

Yaygın bir yaklaşım, önbelleği kullanıp kullanmayacağınıza karar vermeden önce Worker içinde bir oturum çerezinin bulunup bulunmadığını denetlemektir. Oturum çerezi varsa önbelleği tamamen atlayın ve kişiselleştirilmiş bir yanıt oluşturun. Oturum çerezi yoksa sayfa herkese açıktır ve önbellekten sunulabilir.

Cloudflare KV, verileri kullanıcılara yakın konumlarda depolayan, küresel olarak dağıtılmış bir anahtar-değer deposudur. Oluşturulmuş HTML'yi KV'de önbelleğe alabilirsiniz — oluşturulmuş sayfayı TTL içeren bir değer olarak depolayın; sonraki istekler de React ile yeniden oluşturmak yerine uçta KV'den okusun.

KV okumaları hızlıdır; çünkü veriler isteğe hizmet veren uç PoP'a çoğaltılır. Tipik okuma gecikmesi 5 ms'nin altındadır. Ancak KV yazmaları nihai tutarlılık kullanır: bir bölgede yapılan yazma işlemi 60 saniye içinde tüm küresel PoP'lara yayılır; bu nedenle bazı kullanıcılar kısa süreliğine eski verileri görebilir.

Cloudflare R2, çıkış ücreti olmayan, S3 uyumlu bir nesne depolama hizmetidir. KV'ye sığmayan daha büyük varlıklar için uygundur: WASM modülleri, önceden oluşturulmuş OG görselleri ve büyük JSON veri kümeleri. Workers, R2'ye tıpkı KV'de olduğu gibi bağlamalar aracılığıyla erişir.

Cloudflare Enterprise, önbellek etiketlerini destekler: bir yanıta Cache-Tag: product-42 etiketi eklersiniz; product 42 değiştiğinde product-42 ile etiketlenmiş tüm yanıtları temizlemek için Cloudflare API'sini çağırırsınız. Bu, tüm önbelleği temizlemeden yalnızca gerekli önbellek girdilerini geçersiz kılmanızı sağlar.

Worker'ınızın yeni bir sürümünü yayımladığınızda mevcut önbelleğe alınmış HTML, eski JS paketi dosya adlarına başvurabilir. Sağlam bir yaklaşım, dağıtım sürümünü önbellek anahtarlarınıza eklemek veya sürümlendirilmiş paket dosyası adları kullanmaktır (Vite'ın içerik karması aracılığıyla); böylece eski HTML her zaman geçerli ve önbelleğe alınmış JS dosyalarına başvurur.

SSR HTML'sini KV'de önbelleğe alan bir Worker şu düzeni izler: URL'den (ve isteğe bağlı olarak yerel ayardan) bir önbellek anahtarı hesaplayın, KV'de bir sonuç olup olmadığını denetleyin ve varsa önbelleğe alınmış HTML'yi hemen döndürün. Sonuç yoksa React ile oluşturun, sonucu TTL ile KV'de depolayın ve ardından yeni oluşturulmuş HTML'yi döndürün.

Cloudflare KV yazma işlemleri için hangi tutarlılık modelini kullanır?

React uygulamaları için uç önbelleğe alma birden çok stratejiyi bir araya getirir: herkese açık sayfaları CDN'de önbelleğe almak için Cache-Control s-maxage, kişiselleştirilmiş yanıtların paylaşılmasını önlemek için Vary: Cookie, uçta önbelleğe alınmış HTML oluşturmak için KV ve ayrıntılı geçersiz kılma için önbellek etiketleri. KV'nin nihai tutarlılık modeli, yazma işlemlerinin yayılmasının 60 saniyeye kadar sürebileceği anlamına gelir; TTL değerlerinizi ve geçersiz kılma stratejinizi buna göre tasarlayın.