PHP 8.2 ile mikroservislerde önbellek invalidasyonu

Mehmet Akar 3 dk okuma
Redis tabanlı etiketli önbellek mimarisi diyagramı

PHP önbellek invalidasyonu, servis sayısı arttıkça anahtar bazlı silmeyle yönetilemez hâle gelir. Etiket tabanlı önbellek, olay kuyruğu ve tutarlılık penceresiyle bu sorunu nasıl çözebileceğinizi örnek kodla anlatıyorum.

Problem: anahtar bazlı silme ölçeklenmiyor

Bir ürünün fiyatı değiştiğinde yalnızca ürün detayı değil; kategori listeleri, arama sonuçları ve kampanya blokları da eskir. Her birinin anahtarını tek tek bilmek servisler arasında gizli bağımlılık yaratır: fiyat servisi, katalog servisinin önbellek anahtarlarını bilmek zorunda kalır. Yeni bir liste eklendiğinde silme kodu güncellenmezse kullanıcı eski fiyatı görür.

PHP önbellek invalidasyonu için kullanılan yaklaşımlar arasındaki farkı özetlemek kararı kolaylaştırır:

YaklaşımNasıl çalışır?Güçlü yanıZayıf yanı
Anahtar bazlı silmeDeğişen veriye bağlı anahtarlar tek tek silinirBasit ve anlaşılırServisler birbirinin anahtarlarını bilmek zorunda kalır
Yalnızca TTLDeğer süre dolunca kendiliğinden yenilenirEk kod gerektirmezSüre boyunca eski veri görülür
Etiket tabanlıDeğerler etiketlerle yazılır, etiket temizlenince hepsi silinirServisler gevşek bağlı kalırEtiket kümelerinin bakımı gerekir
Sürüm anahtarıAnahtar adına bir sürüm sayacı eklenir, sayaç artınca eski anahtarlar kullanılmazSilme işlemi gerekmezEski değerler TTL dolana kadar bellekte kalır

Çözüm: her kayda etiket

Önbelleğe yazılan her değer, ilgili varlıkların etiketleriyle birlikte saklanır (ör. product:48213, category:112). Redis’te her etiket için anahtar adlarını tutan bir küme (set) yeterlidir. Değişiklik olayı geldiğinde yalnızca etiket temizlenir; o etikete bağlı bütün anahtarlar tek işlemde silinir.

src/Cache/TaggedCache.php
<?php

final class TaggedCache
{
    public function __construct(private Redis $redis) {}

    public function remember(string $key, array $tags, int $ttl, callable $fn): mixed
    {
        $hit = $this->redis->get($key);
        if ($hit !== false) {
            return unserialize($hit);
        }
        $value = $fn();
        $this->redis->setex($key, $ttl, serialize($value));
        foreach ($tags as $tag) {
            $this->redis->sAdd("tag:$tag", $key);
        }
        return $value;
    }

    public function invalidate(string ...$tags): void
    {
        foreach ($tags as $tag) {
            $keys = $this->redis->sMembers("tag:$tag");
            if ($keys) { $this->redis->del(...$keys); }
            $this->redis->del("tag:$tag");
        }
    }
}

Olay kuyruğu ile servisleri ayırmak

Fiyat servisi değişikliği kuyruğa bir olay olarak bırakır; tüketici yalnızca etiketleri bilir:

events/price.updated.json
{
  "event": "price.updated",
  "product_id": 48213,
  "tags": ["product:48213", "category:112", "campaign:autumn"]
}

Bu yapıda fiyat servisi hangi sayfaların önbelleğe alındığını bilmez. Yeni bir liste eklemek, yalnızca o listeyi doğru etiketlerle yazmayı gerektirir.

NOT

Etiket kümelerine, içindeki en uzun TTL kadar süre tanımlayın; aksi hâlde süresi dolmuş anahtar adları bellekte birikir.

Alternatif: sürüm anahtarıyla geçersiz kılma

Bazı durumlarda anahtarları silmek yerine anahtar adının bir parçasını değiştirmek daha basittir. Her kategori için bir sürüm sayacı tutulur; sayaç artınca eski anahtarlar artık okunmaz ve TTL dolduğunda kendiliğinden temizlenir.

invalidate-version.php
<?php

// Kategori listesi anahtarı: sürüm değişince yeni anahtar üretilir
$version = (int) $redis->get('ver:category:112');
$key = "category:112:v{$version}:page:1";

// Kategoride bir ürün değiştiğinde
$redis->incr('ver:category:112');

Bu yöntem silme trafiği oluşturmaz, ama bellekte bir süre eski değerler kalır. Bellek sınırlıysa Redis’in bellek politikasını (ör. allkeys-lru) ve TTL değerlerini birlikte planlayın.

Önbellek boşaldığında aynı anda gelen istekler

Popüler bir anahtar silindiğinde, aynı anda gelen çok sayıda istek kaynağı birlikte sorgulayabilir (cache stampede). Basit bir kilitle yalnızca ilk isteğin değeri yeniden üretmesi, diğerlerinin kısa süre bekleyip önbellekten okuması sağlanabilir.

stampede-lock.php
<?php

// Yalnızca kilidi alan istek değeri yeniden üretir (10 saniyelik kilit)
if ($redis->set("lock:$key", 1, ['nx', 'ex' => 10])) {
    $value = $fn();
    $redis->setex($key, $ttl, serialize($value));
    $redis->del("lock:$key");
}

Tutarlılık penceresini kabul etmek

  • Olay kuyruktan işlenene kadar kısa bir süre eski veri görülebilir; bu pencereyi ölçün ve iş tarafıyla netleştirin.
  • Ödeme ve stok gibi kritik akışlarda önbelleği atlayıp kaynağı okuyun.
  • Tüketici çökerse olaylar kaybolmasın: kuyrukta onay (ack) ve yeniden deneme kullanın.
  • Toplu güncellemelerde etiketleri birleştirip tek seferde silin.

Benzer bir ayrıştırmayı yapılandırılmış AI çıktılarında da kullanıyorum; bkz. yerel LLM’lerden güvenilir JSON çıktısı. Toplu işleri kuyrukla yöneten bir örnek için Yerel AI Ürün Görseli Üretimi projesine bakabilirsiniz.

Önbellek bir performans katmanıdır; doğruluğun kaynağı değildir. Kritik kararlar her zaman kaynağı okumalıdır.

Sonuç

Etiket tabanlı PHP önbellek invalidasyonu, servislerin birbirinin anahtarlarını bilme zorunluluğunu kaldırır ve değişikliklerin bütün listelere tutarlı biçimde yansımasını sağlar. PHP altyapınızın ölçeklenmesi için AI destekli web geliştirme hizmetine göz atabilirsiniz.

Diğer notlar

Tüm notlar →