---
title: "Framework Sihrini Anlamak: Servis Konteyneri Aslında Ne Yapıyor?"
url: "https://cilginyazilim.com/blog/servis-konteyneri-nasil-calisir"
description: "Servis konteyneri ve bağımlılık enjeksiyonu nasıl çalışır? Reflection ile otomatik çözümleme, singleton yönetimi ve 40 satırlık çalışan bir PHP örneği."
published: "2026-10-28T10:00:00+03:00"
modified: "2026-10-28T10:00:03+03:00"
author: "Çılgın Yazılım"
category: "Web Geliştirme ve Frameworkler"
tags: ["php", "framework", "codeigniter", "laravel", "mimari", "yazılım tasarımı", "servis konteyneri", "bağımlılık enjeksiyonu", "dependency injection", "reflection", "tasarım deseni", "singleton", "test edilebilirlik"]
site: "Çılgın Yazılım"
language: "tr"
---

# 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.

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 konteyneri**dir. 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](https://cilginyazilim.com/uploads/blog/2026/08/servis-konteyneri-nasil-calisir-ozet.png)
*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](https://codeigniter.com/user_guide/concepts/services.html) iyi bir karşılaştırma sunar. Konteyneri anlamak, [kimlik doğrulamalı bir API kurarken](https://cilginyazilim.com/blog/adim-adim-kimlik-dogrulamali-api-codeigniter) hangi servisin nerede örneklendiğini kestirmenizi de kolaylaştırır.

Konteynerin ürettiği nesneleri testte kolayca kurmak için [kurucu deseni](https://cilginyazilim.com/blog/test-verisi-builder-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](https://cilginyazilim.com/blog/erken-donus-ile-ic-ice-if-cehennemi) 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ça 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.

---

Kaynak: [Framework Sihrini Anlamak: Servis Konteyneri Aslında Ne Yapıyor?](https://cilginyazilim.com/blog/servis-konteyneri-nasil-calisir)
