Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 89 – Dependency injection fikri

Dependency injection ile new kullanımını azaltın, kodun test edilebilirliğini ve bakımını artırın. Constructor injection örnekleri ve sık yapılan hatalar.

Ders 89 – Dependency injection fikri

Modern PHP uygulamalarında sınıflar arasındaki bağımlılıkları doğrudan new operatörüyle oluşturmak, kodun test edilmesini zorlaştırır, değişiklik maliyetini artırır ve mimarinin esnekliğini azaltır. Dependency Injection (DI) bu sorunun temel çözümüdür: Bağımlılıklar dışarıdan, genellikle sınıfın yapıcı (constructor) metoduna geçirilir. Bu yaklaşımla birim testleri yazmak, farklı veri kaynaklarıyla çalışmak ve gelecekteki refaktörizasyonlar çok daha az çaba gerektirir. Bu ders, DI kavramını adım adım açıklayacak, gerçek bir örnek üzerinden constructor injection uygulamasını gösterecek ve yaygın hatalardan kaçınmanız için ipuçları sunacaktır.

Temeller

Dependency Injection, bir sınıfın ihtiyaç duyduğu diğer nesneleri (örneğin veri tabanı bağlantısı, e-posta göndericisi, logger) kendisi yaratmak yerine dışarıdan almasıdır. Bu iki temel faydayı beraber getirir:

  • Test Edilebilirlik: Bağımlılıkların sahte (mock) nesnelerle değiştirilebilmesi, birim testlerinin izole bir ortamda çalışmasını sağlar.
  • Değişim Esnekliği: Uygulamanın bir kısmını değiştirmek (örneğin PDO yerine MySQLi) sadece konfigürasyon dosyasında yapılır, sınıfların iç kodu dokunulmaz.

DI üç yaygın şekilde uygulanabilir:

  1. Constructor Injection: Bağımlılıklar yapıcı metoduna parametre olarak verilir.
  2. Setter Injection: Bağımlılıklar set metodları aracılığıyla atanır.
  3. Interface Injection: Sınıf bir arayüz üzerinden bağımlılığını alır.

Bu dersde constructor injection üzerine odaklanacağız, çünkü en temiz ve zorunlu bağımlılıkları tanımlamanın en güvenilir yoludur.

Adım adım Dependency Injection uygulaması

Öncelikle basit bir senaryo düşünelim: Bir UserRepository sınıfı, veri tabanına bağlanıp kullanıcı verilerini çeker. Geleneksel yaklaşım şöyle olur:

class UserRepository {
    private PDO $db;
    public function __construct() {
        $this->db = new PDO('mysql:host=localhost;dbname=test', 'root', '');
    }
    public function find(int $id): array {
        $stmt = $this->db->prepare('SELECT * FROM users WHERE id = :id');
        $stmt->execute(['id' => $id]);
        return $stmt->fetch(PDO::FETCH_ASSOC);
    }
}

Bu kodda new PDO(...) doğrudan sınıf içinde gerçekleşir. Test ortamında gerçek veri tabanı yerine hafif bir SQLite ya da bir mock nesne kullanmak mümkün değildir; çünkü new satırı sabittir.

Şimdi aynı sınıfı DI ile yeniden yazalım:

class UserRepository {
    private PDO $db;
    public function __construct(PDO $db) {
        $this->db = $db; // Bağımlılık dışarıdan sağlandı
    }
    public function find(int $id): array {
        $stmt = $this->db->prepare('SELECT * FROM users WHERE id = :id');
        $stmt->execute(['id' => $id]);
        return $stmt->fetch(PDO::FETCH_ASSOC);
    }
}

Yukarıdaki kodda PDO nesnesi dışarıdan geçirilir. Artık UserRepository sadece bir PDO arayüzüne ihtiyaç duyar; hangi veri tabanı sürücüsü olduğu, uygulamanın başka bir yerinde belirlenir.

Bu değişikliği gerçek bir uygulamada nasıl kullanırız? Aşağıdaki adımları izleyin:

  1. Bağımlılıkları oluşturun: index.php gibi bir giriş noktasında tüm ortak nesneleri (PDO, Mailer, Logger) tek bir yerde oluşturun.
  2. İlgili sınıfları enjekte edin: Oluşturulan nesneleri sınıfların yapıcılarına aktarın.
  3. Uygulamayı çalıştırın: Artık sınıflar bağımlılıklarını dışarıdan alır, testlerde sahte nesnelerle kolayca değiştirilebilir.

Aşağıda bütün adımları birleştiren bir örnek bulacaksınız. Bu örnek ders89.php dosyasına kaydedilip yerel bir PHP ortamında çalıştırılabilir.

Örnek kod

İlk örnek, gerçek bir MySQL veri tabanı ile çalışan bir UserService ve UserRepository sınıflarını gösterir. İkinci örnek ise aynı sınıfların birim testi için sahte bir PDO nesnesiyle nasıl kullanılacağını anlatır.

// ders89.php – Gerçek ortam
setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

// 2. Repository ve Service'i enjekte et
$userRepo = new UserRepository($pdo);
$userService = new UserService($userRepo);

// 3. Kullanıcıyı getir ve ekrana bas
$user = $userService->getUserById(1);
print_r($user);
?>
// ders89_test.php – Test ortamı (PHPUnit örneği)
createMock(PDO::class);
        $stmt = $this->createMock(PDOStatement::class);
        $stmt->method('execute')->willReturn(true);
        $stmt->method('fetch')->willReturn(['id'=>1,'name'=>'Test User']);
        $mockPdo->method('prepare')->willReturn($stmt);

        $repo = new UserRepository($mockPdo);
        $service = new UserService($repo);
        $result = $service->getUserById(1);
        $this->assertIsArray($result);
        $this->assertEquals('Test User', $result['name']);
    }
}
?>

Sık yapılan hatalar

  • Bağımlılıkları doğrudan sınıf içinde yaratmak: new kullanımını tamamen kaldırmadığınız sürece DI'nin faydalarından tam anlamıyla yararlanamazsınız.
  • Opsiyonel bağımlılıkları constructor’da zorunlu kılmak: Opsiyonel bir nesne (ör. cache) varsa, varsayılan bir null değer veya ayrı bir setter tercih edilmelidir.
  • Tip bildirimlerini atlamak: PHP 7.4+ tip bildirimleri (ör. PDO $db) kullanılmazsa, yanlış nesne tipleri çalışma zamanında hataya yol açar.
  • Servis konfigürasyonunu daima kod içinde tutmak: Bağlantı dizesi, kimlik bilgileri gibi konfigürasyonlar çevresel değişkenler veya .env dosyası üzerinden alınmalı, sınıfların içinde sabitlenmemelidir.
  • DI Container’ı yanlış kullanmak: Container’ı bir Service Locator gibi kullanmak, bağımlılıkların nereden geldiğini gizler ve test edilebilirliği azaltır.

Özet ve kontrol listesi

Dependency Injection, modern PHP projelerinde kodun sürdürülebilirliğini ve test edilebilirliğini artıran bir mimari pratiktir. Constructor injection, en sık tercih edilen ve en az sürpriz yaratan yaklaşımdır. Aşağıdaki kontrol listesi, kodunuzu DI prensiplerine uygun hale getirmenize yardımcı olur.

  • ✅ Tüm sınıflar dışarıdan bağımlılıklarını alıyor mu?
  • ✅ Bağımlılıkların tipleri doğru şekilde bildirildi mi?
  • ✅ Opsiyonel bağımlılıklar için varsayılan değerler ya da setter metodları mevcut mu?
  • ✅ Konfigürasyon değerleri (DB DSN, API anahtarları) kod içinde sabitlenmemiş mi?
  • ✅ Birim testlerde gerçek veri tabanı yerine mock nesneler kullanılıyor mu?
  • ✅ Hata mesajları kullanıcıya doğrudan gösterilmiyor, loglanıyor mu?

Sık Sorulan Sorular

S1: Dependency Injection bir framework mü, yoksa sadece bir tasarım desen mi?
DI hem bir tasarım deseni (constructor, setter, interface injection) hem de birçok modern framework (Laravel, Symfony) tarafından sağlanan bir hizmet (container) olarak sunulur. Desen, konsept; container ise bu konsepti pratikte uygulamayı kolaylaştıran bir araçtır.

S2: Çok sayıda bağımlılık constructor’da birikirse ne yapmalıyım?
Beşten fazla parametre genellikle sınıfın sorumluluklarının fazla olduğunu gösterir. Bu durumda sınıfları daha küçük, tek sorumluluklu parçalara bölmek (SRP) ve/veya bir “parameter object” (ör. Config sınıfı) kullanmak faydalı olur.

S3: DI Container kullanmak zorunda mıyım?
Hayır. Küçük projelerde manuel enjekte etmek (ör. bir bootstrap dosyasında nesneleri oluşturup geçmek) yeterli olur. Container, büyük ve karmaşık projelerde bağımlılık yönetimini otomatikleştirir, ancak öğrenme eğrisi ve ek bağımlılık getirir.

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

PHP serisinin son dersinde ileri seviye konular, framework seçimi, Composer ekosistemi, mikro pro…

Ders 99 – Güvenli yapılandırma kontrol listesi

Üretim ortamı için PHP yapılandırma ayarlarını adım adım kontrol eden, hatasız ve güvenli bir yap…

Ders 98 – OpCache ve performans ipuçları

OpCache'ın çalışma prensibi, yapılandırma adımları ve gerçek dünyada performans artırmak için pra…

Ders 97 – Fibers’a kısa bakış (PHP 8.1)

PHP 8.1 ile gelen Fibers özelliğini adım adım öğrenin, kooperatif concurrency kavramını kavrayın …

Demo
Büyütülmüş Görsel