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.

İçindekiler
Bu yazıyı dinle
Yapay zekâ sesiyle yaklaşık 2 dakikalık özet
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.

Çö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:
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.
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.
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:
$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 kurulduYaş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.
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.
Bu konuda bir projeniz mi var?
İhtiyacınızı birkaç cümleyle anlatın; uygun yaklaşımı birlikte belirleyelim.
İ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.


