Ö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 tüm 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. Hizmetinizi, içeriğin bu URL'de bulunduğu şekilde 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 yayınlar.

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.

Önbelleğe alma davranışı hakkında daha fazla bilgiyi Google'ın web geliştirici belgelerinde bulabilirsiniz.

Cache-Control ayarlama

Dinamik içeriklerin önbelleğini yönetmek için kullandığınız ana araç Cache-Control üstbilgisidir. Bu üstbilgeyi yapılandırarak içeriğinizin ne kadar süre boyunca önbelleğe alınabileceğini hem tarayıcıya hem de CDN'ye 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 boyunca ö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 sunucuda 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 saatlerce, günlerce hatta aylarca 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ınmış içerik ne zaman yayınlanır?

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 üstbilgisini ayarlayabilirsiniz. Örneğin:

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

Bu durumda, Vary başlığının değeri şudur:

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

Bu ayarlarla, farklı X-My-Custom-Header başlıklarına sahip ancak diğer açılardan aynı olan iki istek ayrı ayrı önbelleğe alınır. Hosting, dinamik içerik için istek gönderildiğinde varsayılan olarak Vary başlığına Cookie ve Authorization eklediğini unutmayın. 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:

  • 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 üstbilgisine 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ışına izin vermek 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.