Sayfa yükleniyor

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

Ders 59 – Exception hiyerarşisi

PHP’de Throwable, Exception ve Error sınıflarının farklarını öğrenin, hiyerarşi içinde doğru yakalama tekniklerini adım adım uygulayın.

Ders 59 – Exception hiyerarşisi

PHP uygulamalarında hatalar kaçınılmazdır; ancak hataları doğru sınıflarla yakalamak, kodun okunabilirliğini, bakımını ve güvenliğini büyük ölçüde artırır. Bu derste, PHP 7 ile birlikte gelen Throwable arayüzünün konumunu, Exception ve Error sınıflarının birbirleriyle ilişkisini ve gerçek dünyada nasıl kullanılacağını ayrıntılı olarak inceleyeceğiz.

Temeller

Throwable, PHP’nin tüm hataları ve istisnaları yakalamasını sağlayan en üst düzey arayüzdür. Bu arayüz iki temel sınıfı kapsar:

  • Exception: Uygulama mantığından kaynaklanan hatalar (ör. veri doğrulama, iş mantığı hataları). Kullanıcı hatalarını temsil eder ve genellikle try/catch blokları içinde yakalanır.
  • Error: PHP motorundan gelen kritik hatalar (ör. ParseError, TypeError, OutOfMemoryError). Bu hatalar, kodun çalışamaz hâle gelmesini gösterir ve genellikle catch (Error $e) ile yakalanabilir.

Her iki sınıf da Throwable arayüzünü uygular, bu yüzden catch (Throwable $e) ifadesi tüm hataları yakalar. Ancak, mümkün olduğunca spesifik bir sınıf yakalamak, hatanın kaynağını daha net anlamamıza yardımcı olur.

Adım adım kullanım

1. Hata tipini belirleyin: Hangi senaryoda hangi tip hatanın ortaya çıkacağını analiz edin. Kullanıcı girdisiyle ilgili bir sorun Exception olurken, eksik bir sınıf tanımı ParseError gibi bir Error üretir.

2. Try bloğunu oluşturun: Potansiyel hatanın oluşabileceği kodu try { ... } içine alın.

3. Spesifik catch blokları ekleyin: Önce en spesifik hataları, ardından daha genel olanları yakalayın. PHP, catch bloklarını sırayla değerlendirir; bir Exception yakalandıysa, daha genel bir Throwable bloğu çalışmaz.

4. Hata işleme mantığını tasarlayın: Hata mesajını loglayın, kullanıcıya dost bir mesaj gösterin ve gerekiyorsa uygulamayı güvenli bir şekilde sonlandırın.

5. Finally bloğu (isteğe bağlı): Kaynakları serbest bırakmak, veritabanı bağlantılarını kapatmak gibi temizlik işlemleri için finally bloğunu kullanın.

Örnek kod

Aşağıdaki örnek, hem Exception hem Error tiplerini ayrı ayrı yakalayan bir yapı gösterir. Kodu ders59.php olarak kaydedip yerel ortamda çalıştırabilirsiniz.

<?php
function bol($a, $b) {
    if (!is_numeric($a) || !is_numeric($b)) {
        throw new InvalidArgumentException('Parametreler sayı olmalı.');
    }
    if ($b == 0) {
        throw new DivisionByZeroError('Sıfıra bölme hatası.');
    }
    return $a / $b;
}

try {
    echo bol(10, 2) . "\n"; // 5
    echo bol(10, 0) . "\n"; // DivisionByZeroError fırlatır
} catch (DivisionByZeroError $e) {
    echo "Motor hatası: " . $e->getMessage() . "\n";
} catch (InvalidArgumentException $e) {
    echo "Uygulama hatası: " . $e->getMessage() . "\n";
} catch (Throwable $e) {
    // Beklenmeyen tüm hatalar burada yakalanır
    echo "Genel hata: " . $e->getMessage() . "\n";
} finally {
    echo "İşlem tamamlandı.\n";
}
?>

İkinci bir örnek, aynı hataları catch (Throwable $e) ile tek bir blokta yakalayıp, hata tipine göre farklı loglama stratejileri uygulamayı gösterir.

<?php
class Log {
    public static function hata($msg) {
        // Gerçek projelerde dosyaya, syslog'a vb. yazılır
        echo "[HATA] $msg\n";
    }
    public static function bilgi($msg) {
        echo "[BİLGİ] $msg\n";
    }
}

try {
    // Bilinçli bir hata üretelim
    nonexistent_function();
} catch (Throwable $e) {
    if ($e instanceof Error) {
        Log::hata('Motor hatası: ' . $e->getMessage());
    } elseif ($e instanceof Exception) {
        Log::hata('Uygulama hatası: ' . $e->getMessage());
    }
    // Hata kodunu ve dosya konumunu da loglayabiliriz
    Log::bilgi('Kod: ' . $e->getCode() . ' | Dosya: ' . $e->getFile());
}
?>

Sık yapılan hatalar

  • Genel catch (Exception $e) kullanmak: Error sınıfları bu blokta yakalanmaz, bu da kritik motor hatalarının gözden kaçmasına yol açar.
  • Catch bloklarını yanlış sırada koymak: catch (Throwable $e) en üstte yer alırsa, daha spesifik bloklar hiç çalışmaz.
  • Hata mesajlarını doğrudan kullanıcıya göstermek: Üretim ortamında ham hata mesajları güvenlik açığı oluşturur.
  • finally bloğunda exception fırlatmak: finally içinde yeni bir hata fırlatmak, orijinal hatanın kaybolmasına neden olabilir.

Özet ve kontrol listesi

Bu derste, Throwable hiyerarşisinin yapısını, Exception ve Error arasındaki farkları ve gerçek dünyada nasıl etkili bir şekilde kullanılacağını öğrendik. Aşağıdaki kontrol listesi, kodunuzu gözden geçirirken size rehberlik edecektir:

  • Hata tipine göre en spesifik catch bloğu kullanıldı mı?
  • Motor hataları (Error) ayrı ayrı yakalanıyor mu?
  • Genel catch (Throwable $e) bloğu sadece en son sırada mı?
  • Hata mesajları loglanıyor, kullanıcıya ise güvenli bir mesaj gösteriliyor mu?
  • Kaynak temizliği için finally bloğu mevcut mu?
  • Üretim ortamında hata detayları gizleniyor mu?

SSS

Soru 1: Throwable ile Exception aynı şey midir?
Hayır. Throwable bir arayüzdür ve Exception ile Error sınıflarını kapsar. Exception uygulama hatalarını, Error ise PHP motorunun kritik hatalarını temsil eder.

Soru 2: catch (Exception $e) tüm hataları yakalar mı?
Hayır. Exception sadece Exception sınıfından türeyen nesneleri yakalar. Error sınıfları bu blokta yakalanmaz; onlar için ayrı bir catch (Error $e) ya da genel catch (Throwable $e) gerekir.

Soru 3: Üretim ortamında hata mesajlarını nasıl güvenli bir şekilde gösteririm?
Hata mesajını log dosyasına kaydedin, kullanıcıya ise “Bir sorun oluştu. Lütfen daha sonra tekrar deneyin.” gibi genel bir mesaj gösterin. Hata kodu, dosya ve satır gibi teknik detayları asla doğrudan kullanıcıya sunmayın.

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