Önbellek davranışını yönet

Firebase Hosting, sitenizi mümkün olduğunca hızlı hale getirmek için güçlü bir küresel CDN kullanır.

İstenen statik içerikler, CDN'de otomatik olarak önbelleğe alınır. Sitenizin içeriğini yeniden dağıtırsanız Firebase Hosting, bir sonraki isteğe kadar CDN'deki tüm önbelleğe alınmış içeriğinizi otomatik olarak temizler.

Ancak Cloud Functions ve Cloud Run hizmetleri içerikleri dinamik olarak oluşturduğundan, belirli bir URL'nin içeriği kullanıcı girişi veya kullanıcının kimliği gibi faktörlere göre değişiklik gösterebilir. Bu nedenle, arka uç kodu tarafından işlenen istekler varsayılan olarak CDN'de önbelleğe alınmaz.

Ancak dinamik içerik için önbelleğe alma davranışını yapılandırabilirsiniz. Örneğin, bir işlev yalnızca düzenli aralıklarla yeni içerik oluşturuyorsa oluşturulan içeriği en azından kısa bir süre için önbelleğe alarak uygulamanızı hızlandırabilirsiniz.

Benzer şekilde, içerik tetiklenen bir işlev yerine CDN'den sunulduğundan işlev yürütme maliyetlerini potansiyel olarak azaltmak için önbelleğe alma davranışını yapılandırabilirsiniz. İşlev yürütme ve hizmetleri optimize etme hakkında daha fazla bilgiyi Cloud Functions ve Cloud Run dokümanlarında bulabilirsiniz.

404 hatası döndüren istekler istisnadır. CDN, hizmetinizin var olmayan bir URL'ye verdiği 404 yanıtını 10 dakika boyunca önbelleğe alır. Böylece, söz konusu URL için sonraki istekler CDN'den sunulur. İçeriğinizin bu URL'de bulunduğu şekilde hizmetinizi değiştirirseniz CDN, önbelleğe alınmış 404'leri en fazla 10 dakika boyunca yayınlamaya devam eder ve ardından içeriği bu URL'den normal şekilde sunar.

Bir 404 yanıtı, Cloud Functions veya Cloud Run hizmetiniz tarafından ayarlanan önbelleğe alma üst bilgilerini zaten içeriyorsa bu üst bilgiler, varsayılan 10 dakika süresini geçersiz kılar ve CDN'nin önbelleğe alma davranışını tamamen belirler.

Google'ın web geliştirici dokümanlarında önbelleğe alma davranışı hakkında daha fazla bilgi edinin.

Cache-Control ayarlama

Dinamik içeriklerin önbelleğini yönetmek için kullandığınız ana araç Cache-Control üstbilgisidir. Bu üst bilgiyi yapılandırarak hem tarayıcıya hem de CDN'ye içeriğinizin ne kadar süreyle önbelleğe alınabileceğini bildirebilirsiniz. İşlevinizde Cache-Control değerini aşağıdaki gibi ayarlarsınız:

res.set('Cache-Control', 'public, max-age=300, s-maxage=600');

Bu örnek başlıkta, yönergeler üç şey yapar:

  • public: Önbelleği public olarak işaretler. Bu, hem tarayıcının hem de ara sunucuların (Firebase Hosting için CDN) içeriği önbelleğe alabileceği anlamına gelir.

  • max-age — Tarayıcıya ve CDN'ye, içeriği kaç saniye önbelleğe alabileceğini bildirir. Ayarlanan süre sona erdiğinde tarayıcı ve CDN, içeriği kaynak sunucuda yeniden doğrulamalıdır. Örnek üstbilgide, tarayıcının ve CDN'nin içeriği beş dakika boyunca önbelleğe almasına izin veriyoruz (CDN önbelleğe almayla ilgili belirli kontroller için aşağıdaki s-maxage bölümüne bakın).

  • s-maxage: Yalnızca CDN önbelleğe alma için max-age yönergesini geçersiz kılar; CDN'ye içeriği kaç saniye boyunca önbelleğe alabileceğini söyler. Ayarlanan süre sona erdiğinde CDN'nin içeriği kaynak sunucuyla yeniden doğrulaması gerekir. Örnek başlıkta, max-age yalnızca CDN için ayarını geçersiz kılıyoruz ve CDN'nin içeriği on dakika boyunca önbelleğe almasına izin veriyoruz.

max-age ve s-maxage için değerlerini, kullanıcıların eski içerikler almasına izin vereceğiniz en uzun süreye ayarlayın. Bir sayfa birkaç saniyede bir değişiyorsa küçük bir zaman değeri kullanın. Ancak diğer içerik türleri saatler, günler, hatta aylar boyunca güvenli bir şekilde önbelleğe alınabilir.

Cache-Control üstbilgisi hakkında daha fazla bilgiyi Mozilla Developer Network'ta ve Google'ın web geliştirici belgelerinde bulabilirsiniz.

Önbelleğe alınan içerik ne zaman sunulur?

Tarayıcı ve CDN, içeriğinizi aşağıdakilere göre önbelleğe alır:

  • Ana makine adı
  • Yol
  • Sorgu dizesi
  • Vary başlığında belirtilen istek başlıklarının içeriği

Vary üstbilgileri

Vary başlığı, uygun bir yanıt sağlamak için hangi istek başlıklarının kullanılacağını (önbelleğe alınan içeriğin geçerli olup olmadığını veya içeriğin kaynak sunucuyla yeniden doğrulanıp doğrulanmayacağını) belirler.

Firebase Hosting, sık karşılaşılan durumlar için yanıtınızda otomatik olarak uygun bir Vary başlığı belirler. Çoğu zaman Vary başlığıyla ilgili endişelenmenize gerek yoktur. Ancak bazı gelişmiş kullanım alanlarında, önbelleği etkilemeniz gereken başka üstbilgileriniz olabilir. Bu durumda, yanıtınızda Vary başlığını ayarlayabilirsiniz. Örneğin:

res.set('Vary', 'Accept-Encoding, X-My-Custom-Header');

Bu durumda, Vary üstbilgisinin değeri şu şekildedir:

vary: X-My-Custom-Header, x-fh-requested-host, accept-encoding, cookie, authorization

Bu ayarlarla, aksi takdirde farklı X-My-Custom-Header üst bilgilerine sahip iki özdeş istek ayrı ayrı önbelleğe alınır. Hosting, dinamik içerik için istek yapıldığında Vary başlığına varsayılan olarak Cookie ve Authorization ekler. Bu sayede, kullandığınız tüm oturum veya çerez yetkilendirme üstbilgilerinin önbelleğe alma anahtarının bir parçası olması sağlanır. Bu da içeriğin yanlışlıkla sızmasını önler.

Ayrıca şunlara dikkat edin:

  • Yalnızca GET ve HEAD istekleri önbelleğe alınabilir. Diğer yöntemleri kullanan HTTPS istekleri hiçbir zaman önbelleğe alınmaz.

  • Vary başlığına ayar eklerken dikkatli olun. Ne kadar çok ayar eklerseniz CDN'nin önbelleğe alınmış içerik yayınlama olasılığı o kadar azalır. Ayrıca Vary'ün yanıt başlıklarına değil, istek başlıklarına dayandığını unutmayın.

Çerezleri kullanma

Firebase Hosting, Cloud Functions veya Cloud Run ile birlikte kullanıldığında çerezler genellikle gelen isteklerden kaldırılır. Bu, verimli CDN önbellek davranışı sağlamak için gereklidir. Yalnızca özel olarak adlandırılmış __session çerezinin uygulamanızın yürütülmesine iletilmesine izin verilir.

Mevcut olduğunda __session çerezi otomatik olarak önbellek anahtarının bir parçası haline gelir. Bu, farklı çerezlere sahip iki kullanıcının diğerinin önbelleğe alınmış yanıtını almasının imkansız olduğu anlamına gelir. __session çerezini yalnızca uygulamanız kullanıcı yetkilendirmesine bağlı olarak farklı içerikler sunuyorsa kullanın.