İçeriğe geç
Çılgın Yazılım

Web Geliştirme ve Frameworkler kod örnekli

Framework Sihrini Anlamak: Servis Konteyneri Aslında Ne Yapıyor?

Bağımlılık enjeksiyonu konteyneri, otomatik gibi görünen çözümlemenin arkasındaki basit fikri gizler. 40 satırda kendimiz yazalım.

Çılgın Yazılım 3 dk okuma

Framework Sihrini Anlamak: Servis Konteyneri Aslında Ne Yapıyor?
İçindekiler
  1. Çözdüğü problem
  2. Kırk satırlık bir konteyner
  3. Yaşam döngüsü: en sık yapılan hata
  4. Framework'ler bunun neresinde?
  5. Ne zaman fazla gelir?
  6. Sonuç

Modern framework'lerde bir controller yazarsınız, kurucuya bir servis tipi koyarsınız ve o servis "kendiliğinden" gelir. Bu davranışın arkasındaki bileşen servis konteyneridir. Sihirli görünmesinin tek sebebi, ne yaptığının nadiren anlatılmasıdır. Oysa temel fikir, kırk satırlık bir sınıfa sığacak kadar basittir.

Servis konteynerinin üç temel sorumluluğu
Konteyner sihir yapmaz; kurucu imzalarını okuyup nesneleri sizin yerinize kurar.

Çözdüğü problem

Konteyner olmadan sınıflar bağımlılıklarını kendileri kurar — bu, aşağıda göreceğimiz gibi test edilebilirliği doğrudan etkiler:

PHP
class SiparisServisi
{
    private PdoBaglanti $db;
    private MailGonderici $mail;

    public function __construct()
    {
        // Sınıf, bağımlılıklarını KENDİSİ seçiyor — burada test edilemez hâle gelir
        $this->db   = new PdoBaglanti('mysql:host=localhost;dbname=shop', 'root', '');
        $this->mail = new MailGonderici('smtp.example.com', 587);
    }
}

Bu kodun iki büyük sorunu var. Birincisi test edilemez: birim testinde gerçek veritabanına ve gerçek SMTP sunucusuna bağlanmak zorundasınız. İkincisi esnek değil: bağlantı ayarları sınıfın içine gömülüdür. Çözüm, bağımlılıkları dışarıdan almaktır — bağımlılık enjeksiyonu tam olarak budur.

PHP
class SiparisServisi
{
    public function __construct(
        private PdoBaglanti $db,
        private MailGonderici $mail,
    ) {}
}

Ama bu sefer nesneyi kuran taraf, tüm bağımlılık ağacını elle kurmak zorunda kalır. İşte konteynerin devreye girdiği yer burasıdır.

Kırk satırlık bir konteyner

Konteynerin işi üç adımdır: istenen sınıfın kurucusuna bak, parametre tiplerini oku, her birini özyinelemeli olarak çöz.

PHP
final class Konteyner
{
    /** @var array<string, callable> Elle tanımlanmış üreticiler */
    private array $baglar = [];

    /** @var array<string, object> Tek örnek (singleton) havuzu */
    private array $ornekler = [];

    public function bagla(string $anahtar, callable $uretici): void
    {
        $this->baglar[$anahtar] = $uretici;
    }

    public function paylasimli(string $anahtar, object $ornek): void
    {
        $this->ornekler[$anahtar] = $ornek;
    }

    public function al(string $sinif): object
    {
        // 1) Hazır örnek var mı?
        if (isset($this->ornekler[$sinif])) {
            return $this->ornekler[$sinif];
        }

        // 2) Elle tanımlanmış üretici var mı? (arayüz → somut sınıf eşlemesi)
        if (isset($this->baglar[$sinif])) {
            return ($this->baglar[$sinif])($this);
        }

        // 3) Otomatik çözümleme: kurucuyu oku, parametreleri özyinelemeli kur
        $yansima = new ReflectionClass($sinif);
        if (! $yansima->isInstantiable()) {
            throw new RuntimeException("$sinif örneklenemez (arayüz/soyut sınıf için bağlama tanımlayın).");
        }

        $kurucu = $yansima->getConstructor();
        if ($kurucu === null) {
            return new $sinif();
        }

        $argumanlar = [];
        foreach ($kurucu->getParameters() as $param) {
            $tip = $param->getType();

            if ($tip instanceof ReflectionNamedType && ! $tip->isBuiltin()) {
                $argumanlar[] = $this->al($tip->getName());       // özyineleme
                continue;
            }

            if ($param->isDefaultValueAvailable()) {
                $argumanlar[] = $param->getDefaultValue();
                continue;
            }

            throw new RuntimeException("{$param->getName()} parametresi çözümlenemedi.");
        }

        return $yansima->newInstanceArgs($argumanlar);
    }
}

Kullanımı şöyle olur:

PHP
$k = new Konteyner();

// Arayüzü somut sınıfa bağla
$k->bagla(MailGonderici::class, fn() => new SmtpGonderici('smtp.example.com', 587));

// Veritabanı bağlantısı tek örnek olsun (her istekte yeniden bağlanmasın)
$k->paylasimli(PdoBaglanti::class, new PdoBaglanti(getenv('DB_DSN'), getenv('DB_USER'), getenv('DB_PASS')));

$servis = $k->al(SiparisServisi::class);   // Tüm ağaç otomatik kuruldu

Yaşam döngüsü: en sık yapılan hata

Konteynerin en kritik kararı "her istekte yeni mi, tek örnek mi?" sorusudur. Durum tutan bir servisi yanlışlıkla paylaşımlı yapmak, istekler arası veri sızıntısına yol açar — üstelik bu hata düşük trafikte hiç görünmez, yoğunlukta patlar.

Kural: durumsuz servisler paylaşımlı olabilir. İçinde kullanıcıya, isteğe veya oturuma özel veri tutan hiçbir nesne paylaşımlı olmamalıdır.

Framework'ler bunun neresinde?

CodeIgniter'ın Services sınıfı, Laravel'in app() yardımcısı, Symfony'nin konteyneri — hepsi bu üç adımın üzerine ek yetenekler koyar: yapılandırma dosyasından bağlama, derleme zamanında önbellekleme (reflection maliyetini kaldırmak için), etiketli servisler, tembel yükleme. Çekirdek fikir aynıdır. CodeIgniter'ın kendi yaklaşımı için resmî servis belgeleri iyi bir karşılaştırma sunar. Konteyneri anlamak, kimlik doğrulamalı bir API kurarken hangi servisin nerede örneklendiğini kestirmenizi de kolaylaştırır.

Konteynerin ürettiği nesneleri testte kolayca kurmak için kurucu deseni doğal bir tamamlayıcıdır.

Ne zaman fazla gelir?

Konteyner her projede gerekli değildir. Üç sınıflık bir betikte new kullanmak daha okunurdur. Konteyner, bağımlılık ağacı derinleştiğinde ve aynı nesnenin farklı ortamlarda farklı uygulamalarla yer değiştirmesi gerektiğinde (üretimde SMTP, testte sahte gönderici) kazanç sağlar. Aşırı soyutlama ise ters teper: her sınıf için ayrı arayüz üretmek, okunabilirlik adına yapılan sadeleştirmelerin tersine, izlenebilirliği düşürür.

Sonuç

Servis konteyneri, kurucu imzalarını okuyup nesneleri sizin yerinize kuran bir yardımcıdır — sihir değil, yansıma (reflection). Üç sorumluluğu vardır: bağlama kaydı, özyinelemeli çözümleme ve yaşam döngüsü yönetimi. Kendi konteynerinizi yazmak üretim için gerekmez, ama framework'ünüzün neyi nasıl yaptığını anlamak hata ayıklarken doğrudan zaman kazandırır. Bir sonraki "bu servis nereden geliyor?" sorusunda, cevabı tahmin etmek yerine konteynerin bağlama tanımına bakabileceksiniz.

Beğeniniz benzer içerikleri öne çıkarmamıza yardımcı olur.

Sık sorulan sorular

Servis konteyneri ile service locator aynı şey mi?

Hayır. Konteyner nesneleri dışarıdan enjekte eder; service locator ise sınıfın içinden konteynere ulaşıp bağımlılık istemesidir. İkincisi bağımlılıkları gizlediği için genelde anti-desen sayılır: sınıfın imzasına bakarak neye ihtiyaç duyduğunu göremezsiniz.

Reflection kullanmak performansı düşürmez mi?

Her istekte tüm ağacı yansımayla çözmek ölçülebilir bir maliyettir. Üretim framework'leri bu yüzden çözümleme planını derleyip önbelleğe alır. Küçük ve orta ölçekli uygulamalarda fark genelde ihmal edilebilir seviyededir, ama ölçmeden varsaymayın.

Arayüz yerine doğrudan somut sınıf enjekte etsem olur mu?

Olur ve çoğu durumda yeterlidir. Arayüz, aynı rolün birden fazla uygulaması olduğunda veya testte yerine sahte nesne koymanız gerektiğinde değer kazanır. Tek uygulaması olan her sınıf için arayüz üretmek gereksiz katman yaratır.

Konteyneri controller içinde çağırmak doğru mu?

Genellikle hayır. Controller kurucusuna ihtiyaç duyduğu servisleri yazmak, o controller'ın bağımlılıklarını görünür kılar. Konteyneri metot içinde çağırmak, gizli bağımlılık yaratır ve testte hangi nesnelerin sahtelenmesi gerektiğini belirsizleştirir.

Yazan

Çılgın Yazılım

Ben Evren Çılgın; yazılım geliştirme, web teknolojileri ve sistem tasarımı alanlarında uzmanlaşmış bir geliştiriciyim. Uzun yıllardır hem frontend hem de backend tarafında üretken, ölçeklenebilir ve kullanıcı dostu çözümler üretiyorum.

Hakkımızda Bize ulaşın

Bu konuda bir projeniz mi var?

İhtiyacınızı birkaç cümleyle anlatın; uygun yaklaşımı birlikte belirleyelim.

Projenizi Anlatın

İlgili yazılar

Yorumlar

Henüz yorum yok. Sorunuzu ya da deneyiminizi ilk siz yazın.

Yorum yazın

Yorumunuz onaylandıktan sonra yayınlanır. Ekibimiz gerekirse konuyla ilgili bir yanıt da paylaşır.

Yayınlanmaz; yalnızca gerektiğinde size ulaşmak için.

En az 10 karakter.

Tüm yazılar