Bir uygulama hata verdiğinde ziyaretçiye dosya yolu veya veritabanı ayrıntısı göstermek uygun değildir. Kullanıcıya anlaşılır sonuç sunmakla geliştiricinin sorunu teşhis etmesi farklı ihtiyaçlardır. Hata mesajını ve teknik günlüğü ayrı tasarlayın.
Beklenen durumla arızayı ayırın
Boş form alanı gibi doğrulama hatası kullanıcı tarafından düzeltilebilir. Veritabanına bağlanamamak ise sistem sorunudur. Her ikisine aynı genel başarısız mesajı vermek kullanıcıyı gereksiz tekrar denemeye yönlendirebilir. İşlemin kaydedilip kaydedilmediğini de açıkça belirtin.
Yakalama noktasını belirleyin
İşlem sınırında istisnayı yakalayıp kontrollü yanıt üretebilirsiniz. Her fonksiyonda hatayı susturmak, asıl arızanın kaybolmasına neden olur. Örnekte işlem fonksiyonu başarılı durumda sonucu döndürür; hata ayrıntısı ziyaretçiye aktarılmaz.
try {
$result = runOperation();
} catch (Throwable $error) {
error_log('operation_failed type=' . get_class($error));
http_response_code(500);
echo 'İşlem tamamlanamadı. Lütfen daha sonra tekrar deneyin.';
exit;
}
runOperation burada örnek uygulama fonksiyonudur. Kendi işlem ve yanıt katmanınızla değiştirilmelidir. JSON API içinde HTML metni yazmak yerine API’nin belirlediği hata biçimini kullanın.
Günlüğe hassas veri koymayın
Parola, erişim anahtarı, oturum bilgisi ve tam form içeriği hata kaydına dökülmemelidir. Daha ayrıntılı günlük gerekiyorsa ayıklanmış bağlam ve işlem kimliği kullanın. Log dosyasını ziyaretçinin indirebildiği dizinde tutmayın; erişim ve saklama süresini düzenleyin.
Üretim ayarını doğrulayın
Geliştirme ekranıyla canlı site aynı hata gösterim politikasını kullanmamalıdır. Hata günlüğünün gerçekten yazıldığını kontrollü testle doğrulayın. Sessiz sayfa, hata yok anlamına gelmez; günlük de çalışmıyor olabilir. Amaç problemi saklamak değil, doğru kişiye doğru ayrıntıyı ulaştırmaktır.
Yazı hakkında konuş