SOLID Prensipleri Gerçek Kod Örnekleriyle Nasıl Uygulanır? (Adım Adım Mimari Rehber)

1. Giriş ve Karşılaşılan Temel Zorluklar

Bir özelliği değiştirirken sistemin alakasız başka yerlerinin bozulması (Fragile Code) ve yeni özellik eklemenin günler sürmesi, SOLID prensiplerinin ihlal edildiğinin en açık göstergesidir.

Modern kurumsal yazılım mimarisinde bu adımı doğru tasarlamak; hem uygulamanın bakım maliyetini (maintainability) düşürür hem de gelecekteki ölçekleme (scaling) süreçlerinde refactor ihtiyacını en aza indirir. Bu rehberde, sektörde kabul görmüş standartlar ışığında adım adım uygulamayı ele alıyoruz.

2. Ortam Hazırlığı ve Gerekli Bağımlılıklar

Geliştirmeye başlamadan önce sistem ortamınızın ve ilgili paketlerin hazır olduğundan emin olmalısınız. Terminalinizde aşağıdaki komutları çalıştırarak ilgili yapılandırmayı tamamlayın:

• Adım: Mevcut kod tabanındaki devasa 'Tanrı Sınıfları' (God Objects) tespit edin.
• Adım: Sorumlulukları Single Responsibility (SRP) ilkesiyle küçük parçalara ayırın.

3. Uygulama Mimarisi ve Kod Örneği

Aşağıdaki kod bloğunda, temiz kod (Clean Code) prensiplerine ve SOLID standartlarına uygun olarak tasarlanmış örnek implementasyonu inceleyebilirsiniz:

<?php
// SOLID: Open/Closed Principle (OCP) ve Dependency Inversion (DIP)

// 1. Soyutlama (Interface) Tanımı
interface NotificationSenderInterface
{
    public function send(string $to, string $message): bool;
}

// 2. Somut İmplementasyonlar (Genişletmeye Açık)
class EmailNotificationSender implements NotificationSenderInterface
{
    public function send(string $to, string $message): bool
    {
        // E-posta gönderim mantığı
        return true;
    }
}

class SmsNotificationSender implements NotificationSenderInterface
{
    public function send(string $to, string $message): bool
    {
        // SMS API gönderim mantığı
        return true;
    }
}

// 3. Yüksek Seviyeli İş Sınıfı (Değişime Kapalı, Soyutlamaya Bağımlı)
class OrderStatusNotifier
{
    public function __construct(
        protected NotificationSenderInterface $sender
    ) {}

    public function notifyCustomer(string $recipient, string $orderStatus): void
    {
        $message = "Siparişinizin yeni durumu: " . $orderStatus;
        $this->sender->send($recipient, $message);
    }
}

4. Kod Analizi ve Çalışma Mantığı

OrderStatusNotifier sınıfı, bildirimin e-posta mı yoksa SMS mi gittiğini bilmez; sadece NotificationSenderInterface sözleşmesine güvenir. Yarın WhatsApp bildirimi eklemek istediğimizde mevcut koda tek bir satır dokunmadan yeni bir sınıf yazıp enjekte edebiliriz (OCP).

Yukarıdaki implementasyonda dikkat edilmesi gereken en kritik husus, işlemlerin bağımsız (decoupled) ve test edilebilir şekilde katmanlara ayrılmış olmasıdır. Bu yaklaşım, birim testlerin (Unit Tests) ve entegrasyon testlerinin hızlıca yazılabilmesine olanak tanır.

5. Performans ve Güvenlik İpuçları

Canlı üretim (production) ortamında sistemin kararlı çalışması için aşağıdaki pratikleri mutlaka dikkate almalısınız:

• Bir sınıfın değişmesi için yalnızca TEK bir neden olmalıdır (Single Responsibility).
• Üst sınıflar alt sınıfların yerine hatasız geçebilmelidir (Liskov Substitution Principle).
• İstemcileri kullanmadıkları metotları içeren şişkin arayüzlere zorlamayın (Interface Segregation Principle).

6. En Sık Yapılan Hatalar ve Hata Ayıklama (Troubleshooting)

Gereksiz yere her basit 3 satırlık fonksiyon için interface oluşturmak aşırı mühendislik (over-engineering) tuzağıdır.

Eğer beklenmedik bir hata ile karşılaşırsanız; öncelikle log dosyalarını incelemeli, ortam değişkenlerinin (.env) doğru tanımlandığını doğrulamalı ve önbellek (cache) mekanizmalarını temizleyerek sistemi yeniden başlatmalısınız.

7. Sonuç ve Mimari Değerlendirme

SOLID prensiplerine sadık kalarak inşa edilen yazılımlar; yıllar geçse de eskimez, kolayca test edilir ve şirketlere milyonlarca liralık bakım tasarrufu sağlar.

Cengiz Bozdemir olarak 18 yılı aşkın kurumsal yazılım mimarlığı deneyimimle tavsiyem; sistem tasarımında her zaman sürdürülebilirlik, güvenlik ve yüksek eşzamanlılık (high concurrency) hedeflerini ön planda tutmanızdır. Kurumsal projelerinizde özel mimari danışmanlık veya uçtan uca yazılım geliştirme desteği için bizimle iletişime geçebilirsiniz.