Sayfa yükleniyor

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

Ders 61 – Özel exception sınıfları

Domain’e özel exception sınıflarıyla hataları anlamlı yakalayın, güvenli mesajlar üretin ve kodunuzu daha okunur hâle getirin.

Ders 61 – Özel exception sınıfları

Uygulama geliştirirken hatalar kaçınılmazdır; fakat hataların nasıl ele alındığı, kodun bakımını, güvenliğini ve kullanıcı deneyimini doğrudan etkiler. PHP'de standart Exception sınıfı her türlü hatayı yakalamak için yeterli görünse de, iş mantığına özgü hataları ayırt etmek zorlaşabilir. Bu derste, domain’e özel exception sınıfları oluşturmanın neden önemli olduğunu, nasıl tasarlanacağını ve gerçek bir senaryoda nasıl kullanılacağını adım adım inceleyeceğiz. Böylece hata yönetiminiz daha anlamlı, test edilebilir ve güvenli hâle gelecektir.

Temeller

PHP, Throwable arayüzünü uygulayan iki temel sınıf sunar: Exception ve Error. Çoğu uygulama hatası Exception üzerinden yönetilir. Ancak bir e-ticaret sisteminde "Stok yok" hatası, bir bankacılık uygulamasında "Yetersiz bakiye" hatası gibi iş alanına özgü durumlar, genellikle aynı Exception sınıfı içinde toplandığında karışıklığa yol açar. Bu durum iki sorunu beraberinde getirir:

  • Hata yakalama blokları çok geniş olur; hangi hatanın gerçekleştiğini ayırt etmek zorlaşır.
  • Hata mesajları içinde hassas iş verisi (ör. ürün ID'si, müşteri numarası) sızdırılabilir.

Domain’e özgü bir exception sınıfı tanımlayarak bu problemleri çözebiliriz. Böyle bir sınıf, yalnızca ilgili alanla ilgili hataları temsil eder ve catch bloklarında tip bazlı filtreleme yapmamıza olanak tanır.

Adım adım özel exception tasarımı

Özel bir exception sınıfı oluşturmak aslında çok basittir: RuntimeException ya da Exception sınıfını genişletiriz. Ancak üretim ortamında kullanılacak sınıflar için bazı iyi uygulamaları göz önünde bulundurmak gerekir:

  1. İsimlendirme: Sınıf adı, hatanın neyle ilgili olduğunu açıkça belirtmelidir. Örneğin StokYokException veya YetersizBakiyeException.
  2. İstemciye gösterilecek mesaj: Exception mesajı, geliştiricinin hatayı hızlıca anlamasını sağlayacak ama aynı zamanda hassas veri içermemelidir.
  3. Ek veri taşıma: Gerekirse hatanın oluştuğu bağlamı (ör. ürün ID'si, sipariş numarası) tutmak için sınıfa ek özellikler eklenebilir. Bu özellikler sadece loglama amaçlı kullanılmalı, doğrudan kullanıcıya yansıtılmamalıdır.
  4. Loglama: Özel exception sınıfları, __toString() metodunu özelleştirerek log formatını standart hâle getirebilir.

Aşağıdaki örnek, bir e-ticaret sisteminde stok kontrolü yapan bir servis sınıfı ve ona özgü StokYokException sınıfını gösterir.

Örnek kod

urunId = $urunId;
        $this->istenenMiktar = $istenenMiktar;
        parent::__construct($mesaj, $code, $previous);
    }

    public function getUrunId(): int
    {
        return $this->urunId;
    }

    public function getIstenenMiktar(): int
    {
        return $this->istenenMiktar;
    }

    // Loglama için okunabilir bir temsil
    public function __toString(): string
    {
        return __CLASS__ . ": Ürün ID {$this->urunId}, istenen miktar {$this->istenenMiktar}. {$this->message}";
    }
}

// Stok kontrol servisi
class StokServisi
{
    private array $stok = [
        101 => 5,
        102 => 0,
        103 => 12,
    ];

    public function stokKontrol(int $urunId, int $miktar): void
    {
        $mevcut = $this->stok[$urunId] ?? 0;
        if ($miktar > $mevcut) {
            // Hassas veri mesaj içinde yer almamalı, sadece loglanmalı
            throw new StokYokException($urunId, $miktar);
        }
        // Stok yeterli ise devam eder
    }
}

// Kullanım örneği
$servis = new StokServisi();
try {
    $servis->stokKontrol(101, 7);
} catch (StokYokException $e) {
    // Kullanıcıya genel bir mesaj gösterilir
    echo "Üzgünüz, talep ettiğiniz ürün yeterli stokta bulunmamaktadır.";
    // Geliştirici log dosyasına detaylı bilgi yazabilir
    error_log($e);
}
?>

Yukarıdaki kodda dikkat edilmesi gereken noktalar:

  • Exception sınıfı, hatanın oluştuğu bağlamı (ürün ID ve istenen miktar) tutar.
  • Mesaj sadece geliştiriciye yönelik, kullanıcıya gösterilmez.
  • catch (StokYokException $e) bloğu, sadece stokla ilgili hataları yakalar; diğer hatalar ayrı bir catch ile ele alınabilir.

Sık hatalar ve kaçınma yolları

Özel exception sınıfları geliştirirken yeni başlayanların sık yaptığı hatalar şunlardır:

  • Hassas veri sızdırma: Exception mesajına doğrudan veri tabanı ID'si, kullanıcı e‑posta adresi gibi bilgiler koymak, güvenlik açığı yaratır. Bunun yerine mesajı sabit tutup, detayları sadece loglara yazın.
  • Çok derin miras zinciri: Exception sınıfını gereksiz yere birden fazla katmanla genişletmek, kodun anlaşılmasını zorlaştırır. Genellikle bir katman yeterlidir.
  • Catch bloğunda çok genel tip kullanmak: catch (Exception $e) yerine, domain’e özgü tipleri yakalayarak hataları ayırın.
  • Exception içinde iş mantığı yürütmek: Exception sınıfları sadece veri taşımalı; içinde veri tabanı sorgusu ya da dış API çağrısı bulunmamalıdır.

Bu hatalardan kaçınmak, kodunuzun test edilebilirliğini ve güvenliğini artırır.

Özet

Domain’e özgü exception sınıfları, hata yönetimini üç açıdan iyileştirir:

  1. Okunabilirlik: catch (StokYokException $e) gibi ifadeler, kodun ne tür bir hata beklediğini açıkça gösterir.
  2. Güvenlik: Hassas iş verileri log içinde tutulur, kullanıcıya gösterilmez.
  3. Bakım: Hata tipine göre farklı iş akışları tanımlanabilir; yeni bir domain hatası eklemek sadece yeni bir sınıf tanımlamayı gerektirir.

Bu dersin sonunda, kendi projelerinizde aşağıdaki kontrol listesini uygulayarak özel exception sınıflarını sorunsuz bir şekilde entegre edebilirsiniz.

  • Exception sınıfı anlamlı bir isim taşıyor mu?
  • Mesaj içinde hassas veri bulunuyor mu?
  • Gerekli bağlam bilgileri sınıf içinde saklanıyor mu?
  • Loglama stratejiniz belirli ve tutarlı mı?
  • Catch blokları tip bazlı ayrılmış mı?

Sık Sorulan Sorular

1. RuntimeException ile Exception arasındaki fark nedir?

RuntimeException, çalışma zamanında ortaya çıkan ve programın akışını kesebilecek hataları temsil eder. Exception ise daha genel bir üst sınıftır; checked/unchecked ayrımı PHP'de bulunmaz, bu yüzden çoğu zaman RuntimeException tercih edilir çünkü daha spesifik bir anlam taşır.

2. Özel exception sınıflarını autoload ile nasıl yönetirim?

PSR‑4 standartlarına uygun bir dizin yapısı oluşturup, sınıf isimlerini namespace ile eşleştirerek composer dump-autoload komutuyla otomatik yüklemeyi sağlayabilirsiniz. Böylece use App\Exception\StokYokException; gibi ifadelerle sınıflarınızı rahatça çağırabilirsiniz.

3. Üretim ortamında exception mesajını tamamen gizlemek mümkün mü?

Evet. ini_set('display_errors', '0'); ve error_reporting(0); ayarlarıyla hataların ekrana basılmasını engelleyebilir, set_exception_handler() ile kendi loglama ve kullanıcıya gösterilecek mesaj mantığınızı tanımlayabilirsiniz.

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