Özellik Bayrakları (Feature Flag) ile Yayını Dağıtımdan Ayırmak

Bir özellik bayrağı, kodun içindeki bir anahtardır: özellik dağıtılmıştır ama açık olup olmadığına çalışma zamanında karar verilir. Bu ayrım kulağa küçük gelir, ancak yazılım tesliminin en riskli anını — "her şey aynı anda canlıya çıkıyor" anını — ortadan kaldırır.

Dağıtım ve yayın aynı şey değildir

Klasik akışta kodu dağıtmak ile özelliği kullanıcılara açmak tek bir olaydır. Sorun çıkarsa tek çare geri almaktır ve bu, o dağıtımdaki diğer düzeltmeleri de geri alır. Bayrak kullandığınızda özelliği kapatmak yeterlidir; kalan değişiklikler yerinde durur. Geri alma stratejisini geri alma planı yazımızda ele almıştık — bayraklar bu planın en ucuz biçimidir.

Basit ama yeterli bir uygulama

final class Bayraklar
{
    /** @var array<string, array> */
    private array $tanimlar;

    public function __construct(private ?int $kullaniciId = null)
    {
        // Kaynak: veritabanı veya yapılandırma. Önbelleğe alınmalı.
        $this->tanimlar = cache()->remember('bayraklar', 60, static fn() =>
            array_column(db_connect()->table('ozellik_bayraklari')->get()->getResultArray(), null, 'anahtar')
        );
    }

    public function acik(string $anahtar): bool
    {
        $b = $this->tanimlar[$anahtar] ?? null;

        // Tanımsız bayrak KAPALI sayılır: yazım hatası özelliği kazara açmasın
        if ($b === null || (int) $b['aktif'] !== 1) {
            return false;
        }

        // Belirli kullanıcılar (iç ekip, pilot müşteri)
        $liste = array_filter(array_map('intval', explode(',', (string) $b['kullanicilar'])));
        if ($this->kullaniciId && in_array($this->kullaniciId, $liste, true)) {
            return true;
        }

        $oran = (int) $b['yuzde'];
        if ($oran >= 100) { return true; }
        if ($oran <= 0)   { return false; }

        // Kullanıcı yoksa oranı uygulama: anonim ziyaretçide kararlılık sağlanamaz
        if (! $this->kullaniciId) {
            return false;
        }

        // KARARLI dağıtım: aynı kullanıcı her istekte aynı sonucu alır
        return (crc32($anahtar . ':' . $this->kullaniciId) % 100) < $oran;
    }
}

Kullanımı okunur tutmak

$bayraklar = new Bayraklar(session()->get('user_id'));

if ($bayraklar->acik('yeni_siparis_akisi')) {
    return $this->yeniSiparisAkisi();
}

return $this->eskiSiparisAkisi();

Bayrak kontrolünü dağıtmayın. Aynı bayrağı on farklı yerde sorgulamak, temizlik zamanı geldiğinde hepsini bulmayı zorlaştırır. Mümkünse kontrolü giriş noktasında yapıp aşağıya karar sonucunu geçirin.

Bayrak durumlarının kim tarafından ne zaman değiştirildiğini görmek isterseniz bu değişiklikleri olay günlüğüne yazmak en sade çözümdür.

Bayrak borcu: en gerçek maliyet

Bayrakların bilinen ve kaçınılmaz sorunu birikmeleridir. Her bayrak kodda bir dallanma, testte iki senaryo demektir. On bayrak teorik olarak 1024 kombinasyon üretir; pratikte kimse bunu test etmez ve beklenmedik etkileşimler ortaya çıkar.

Disiplin basittir: yayın bayrakları geçicidir. Bayrağı eklerken kaldırma tarihini de tanımlayın ve bu tarihi görünür kılın.

-- Süresi geçmiş bayrakları raporlayan sorgu (haftalık çalıştırın)
SELECT anahtar, aciklama, yuzde, kaldirma_tarihi,
       DATEDIFF(CURDATE(), kaldirma_tarihi) AS gun_gecikme
FROM ozellik_bayraklari
WHERE tur = 'yayin'
  AND kaldirma_tarihi < CURDATE()
ORDER BY gun_gecikme DESC;

Bu sorgunun çıktısını sprint planlamaya girdi yapmak, bayrak borcunu teknik borcun görünür bir kalemi hâline getirir. Kapsamın sessizce büyümesini önlemek içinse kapsam kayması yönetimi yazımızdaki çerçeve tamamlayıcıdır.

Bayrakla yayına alınan işin süresi ve maliyeti sorulduğunda maliyet ve süre SSS sayfamız ortak bir dil kurmayı kolaylaştırır.

Bayrak türlerini karıştırmayın

Yayın bayrağı haftalar yaşar ve silinir. Deney bayrağı testin süresi kadar yaşar; sonucu erken durdurma tuzağına düşmeden okunmalıdır. İşletme bayrağı (müşteri paketine göre özellik açma) ise kalıcıdır ve aslında bir yetkilendirme kuralıdır — onu bayrak sistemine değil, izin modeline koymak daha doğrudur. Bu ayrımın yapılmaması, "temizlenemeyen bayrak" yığınının en yaygın sebebidir.

Trunk-based geliştirme ile bayraklar birbirini tamamlar: uzun ömürlü dal açmadan, yarım özelliği kapalı bayrak arkasında ana dala birleştirebilirsiniz. Bu ilişki için dallanma stratejisi yazımıza ve Martin Fowler'ın feature toggle makalesine bakabilirsiniz.

Sonuç

Özellik bayrakları, yazılım tesliminde riski zamana yayan en basit araçtır: kodu dağıtırsınız, özelliği hazır olduğunuzda açarsınız, sorun çıkarsa saniyeler içinde kapatırsınız. Kurarken üç kurala uyun — tanımsız bayrak kapalı sayılsın, oran dağıtımı kullanıcı bazında kararlı olsun, her yayın bayrağının bir kaldırma tarihi bulunsun. Bayrak eklemek bir günlük iştir; onu zamanında kaldırmak ise sistemin uzun vadeli sağlığını belirler. Bir sonraki riskli özelliğinizi bayrak arkasında dağıtmayı deneyin, ilk kapatma anında getirisini göreceksiniz.