Statik dosyalar için uzun cache süresi nasıl güvenli uygulanır?

Statik dosyalar; görseller, CSS, JavaScript, font dosyaları ve ikonlar gibi ziyaretçiye çoğu zaman değişmeden sunulan varlıklardır. Bu dosyalar için uzun cache süresi tanımlamak, sayfa açılış hızını ciddi biçimde iyileştirir; ancak yanlış uygulandığında kullanıcıların eski tasarımı, bozuk scriptleri veya güncellenmemiş görselleri görmesine neden olabilir. Güvenli yaklaşım, uzun önbellekleme süresini dosya sürümleme ve doğru sunucu başlıklarıyla birlikte yönetmektir.

Uzun cache süresi ne zaman mantıklıdır?

Uzun cache süresi, içeriği sık değişmeyen dosyalar için uygundur. Logo, tema CSS dosyaları, derlenmiş JavaScript paketleri, web fontları ve optimize edilmiş görseller bu kapsama girer. HTML sayfaları, sepet sayfası, kullanıcı paneli veya dinamik fiyat alanları ise aynı mantıkla agresif şekilde önbelleğe alınmamalıdır.

Buradaki temel ayrım şudur: Statik dosya değiştiğinde dosya adını veya sorgu sürümünü değiştirebiliyorsanız uzun cache güvenlidir. Değişiklikleri aynı dosya adı üzerinden yayınlıyorsanız ziyaretçinin tarayıcısı eski dosyayı kullanmaya devam edebilir.

Güvenli uygulamanın temel prensibi: sürümleme

Uzun cache süresini güvenli kılan en kritik yöntem cache busting yani sürümlemedir. Örneğin style.css yerine style.2026-06.css veya app.a8f31c.js gibi dosya adı kullanıldığında tarayıcı yeni dosyayı farklı bir kaynak olarak algılar. Böylece bir yıl cache verilmiş olsa bile güncelleme anında yeni dosya yüklenir.

WordPress tarafında tema ve eklenti geliştirirken wp_enqueue_style ve wp_enqueue_script fonksiyonlarında sürüm parametresinin doğru verilmesi önemlidir. Dosya değiştirilmesine rağmen sürüm aynı kalırsa, kullanıcı tarafında eski CSS veya JavaScript kullanılabilir. Bu durum özellikle görsel bozulmalar, çalışmayan menüler ve form hataları olarak fark edilir.

Cache-Control başlıkları nasıl düşünülmeli?

Statik dosyalar için yaygın yaklaşım, uzun bir max-age değeri belirlemek ve mümkünse immutable direktifini kullanmaktır. Örneğin sürümlenmiş CSS, JS, font ve görsel dosyaları için 6 ay veya 1 yıl cache süresi tercih edilebilir. Ancak immutable, yalnızca dosya değiştiğinde URL de değişiyorsa kullanılmalıdır.

• CSS ve JS: Dosya adı hash veya versiyon içeriyorsa uzun cache uygundur.
• Font dosyaları: Nadiren değiştiği için uzun cache için iyi adaydır.
• Görseller: Ürün görselleri sık değişiyorsa dosya adı veya medya URL stratejisi kontrol edilmelidir.
• HTML: Genellikle kısa süreli veya kontrollü cache ile yönetilmelidir.

Sunucu ve CDN tarafında dikkat edilmesi gerekenler

Kullandığınız hosting altyapısı, cache başlıklarının nereden yönetileceğini belirler. Bazı ortamlarda bu ayarlar kontrol panelinden yapılırken, bazı sunucularda Nginx, Apache veya CDN kuralı üzerinden tanımlanır. Aynı dosya için hem sunucu hem CDN farklı cache politikası uyguluyorsa beklenmeyen sonuçlar ortaya çıkabilir.

Pratik kontrol için tarayıcı geliştirici araçlarında Network sekmesini açıp ilgili CSS veya JS dosyasının yanıt başlıklarını inceleyin. cache-control, expires, etag ve last-modified alanları size dosyanın nasıl önbelleğe alındığını gösterir. CDN kullanıyorsanız ayrıca edge cache ve browser cache sürelerinin ayrı ayrı tanımlanıp tanımlanmadığını kontrol edin.

En sık yapılan hatalar

• Dosya adını değiştirmeden 1 yıl cache vermek.
• HTML çıktısına statik dosya gibi uzun cache uygulamak.
• CDN temizlendiği halde tarayıcı cache süresini unutmak.
• WordPress eklentilerinin eklediği CSS ve JS dosyalarının sürüm bilgisini kontrol etmemek.
• Testi yalnızca yönetici oturumuyla yapmak; gerçek ziyaretçi deneyimini incelememek.

WordPress sitelerde uygulanabilir kontrol listesi

Önce tema ve eklentilerin statik dosyaları nasıl çağırdığını kontrol edin. Dosyalar sürüm parametresiyle geliyorsa, bu sürümün güncellemelerde değiştiğinden emin olun. Derleme sistemi kullanıyorsanız hash’li dosya adları en güvenli yöntemlerden biridir.

Ardından performans eklentinizin, CDN’inizin ve sunucu ayarlarınızın aynı hedefe hizmet ettiğini doğrulayın. Örneğin CSS için uzun tarayıcı cache’i verilirken HTML için kısa veya koşullu cache tercih edilebilir. WooCommerce gibi dinamik yapılarda sepet, ödeme ve hesabım sayfalarının agresif cache dışında bırakılması gerekir.

Canlıya almadan önce gizli sekmede, farklı tarayıcıda ve mümkünse mobil bağlantıda test yapın. Bir CSS değişikliği yayınlayın, ardından eski ziyaretçi senaryosunu simüle ederek yeni dosyanın gerçekten yüklendiğini kontrol edin. Bu test, teoride doğru görünen cache kurgusunun pratikte güvenli çalışıp çalışmadığını hızlıca gösterir.

İdeal cache süresi nasıl seçilir?

Tek bir doğru süre yoktur; dosyanın değişme sıklığına göre karar verilmelidir. Hash’li ve sürümlenmiş statik dosyalar için 31536000 saniye yani yaklaşık 1 yıl tercih edilebilir. Daha sık değişebilen medya dosyalarında 30 gün veya 90 gün daha dengeli olabilir. Kritik nokta, uzun süreyi yalnızca değiştiğinde URL’si yenilenen varlıklara vermektir.

Kurumsal sitelerde operasyonel güvenlik açısından küçük bir yayın prosedürü oluşturmak faydalıdır: dosya değiştiğinde sürüm artırılır, CDN gerekiyorsa temizlenir, ardından tarayıcı başlıkları kontrol edilir. Bu düzen sayesinde hosting kaynakları daha verimli kullanılırken ziyaretçi de güncel ve hızlı bir deneyim alır.