WordPress’te Hata Ayıklama Nasıl Etkinleştirilir?
İçindekiler ✓
WordPress siteleri geliştirme veya güncelleme aşamasında sık sık çeşitli teknik hatalarla karşılaşabilir. Bu gibi durumlarda problemin kaynağını tespit edebilmek için hata ayıklama modunun etkinleştirilmesi gerekir. Hata ayıklama, geliştiricilere kodda ya da yapılandırmada meydana gelen sorunları tespit edip çözüm üretme imkanı tanır.
Bu kapsamlı rehberde, hata ayıklama özelliğini WordPress’te nasıl aktif hale getireceğinizi, hangi dosyalar üzerinden müdahale edebileceğinizi ve yaygın sorunları nasıl teşhis edebileceğinizi adım adım açıklıyoruz.
Hata Ayıklama Nedir?
Hata ayıklama (debugging), yazılım geliştiricilerin kodlardaki hataları, uyarıları veya uyumsuzlukları tespit ederek düzenlemesini sağlayan bir süreçtir. WordPress’in yerleşik hata ayıklama sistemi, özellikle geliştiriciler için çok faydalı olan WP_DEBUG sabitiyle kontrol edilir.
WordPress’te hata ayıklama modunu etkinleştirerek:
PHP hatalarını ve uyarılarını görebilirsiniz.
Tema ve eklenti uyumsuzluklarını anlayabilirsiniz.
Deprecated (kullanımdan kaldırılmış) fonksiyonları fark edebilirsiniz.
Hata Ayıklama Neden Etkinleştirilmeli?
1. Geliştirme Sürecinde Hataları Yakalamak
Yeni bir tema, eklenti veya özel işlev geliştiriyorsanız, hata ayıklama açık olduğunda sistemin size gösterdiği hatalar sayesinde daha temiz ve optimize bir kod ortaya çıkarabilirsiniz.
2. Beyaz Ekran Sorununu Çözmek
Bazı hatalar WordPress’te beyaz ekran (White Screen of Death) sorununa yol açar. Hata ayıklama moduyla bu tür sorunların kökeni kolayca bulunabilir.
3. Hosting Sunucusu Hatalarını Anlamak
Bazı hosting sunucularında özel yapılandırmalar veya eksik uzantılar olabilir. Bu tür sunucu hataları genellikle sessizce geçilir, ancak debug açıkken fark edilir.
WordPress’te Hata Ayıklama Nasıl Açılır?
1. wp-config.php Dosyasını Düzenleyin
WordPress ana dizininde bulunan wp-config.php dosyasını FTP veya dosya yöneticisi ile açarak aşağıdaki kodları bulun:
Bu satırı şu şekilde değiştirin:
Eğer bu satır yoksa, /* That's all, stop editing! Happy publishing. */ satırının hemen üzerine aşağıdaki satırları ekleyin:
Bu yapılandırmaların anlamı şöyledir:
WP_DEBUG: Genel hata ayıklama modunu açar.WP_DEBUG_LOG: Tüm hatalarıwp-content/debug.logdosyasına kaydeder.WP_DEBUG_DISPLAY: Hataların tarayıcıda gösterilip gösterilmeyeceğini belirler (canlı sitelerde false olmalı).
Hata Ayıklama Dosyası: debug.log
Hata kayıtları varsayılan olarak wp-content/debug.log dosyasına kaydedilir. Bu dosya yoksa WordPress otomatik olarak oluşturur.
debug.log dosyasında görebileceğiniz örnek bir hata:
Bu kayıtlar sayesinde hangi dosyada, hangi satırda hata olduğunu açık şekilde görebilirsiniz.
WP-CLI ile Hata Ayıklama
Eğer WP-CLI kullanıyorsanız hata ayıklama modunu komut satırından da açabilirsiniz:
Bu komutlar wp-config.php dosyasını otomatik olarak düzenler.
Canlı Sitelerde Hata Ayıklama Güvenliği
Canlı yayındaki bir sitede WP_DEBUG_DISPLAY ayarını false yapmanız büyük önem taşır. Aksi takdirde sitenizi ziyaret eden herkes hata mesajlarını görebilir ve bu durum güvenlik riski oluşturur.
Ayrıca debug.log dosyasının doğrudan erişime kapalı olması gerekir. Bunun için .htaccess dosyanıza şu satırı ekleyebilirsiniz:
Gelişmiş Hata Ayıklama Araçları
1. Query Monitor Eklentisi
Query Monitor eklentisi ile SQL sorguları, PHP hataları, AJAX çağrıları ve daha fazlasını kontrol edebilirsiniz.
2. Error Log Monitor
Bu eklenti sayesinde debug.log dosyasını WordPress yönetim panelinden kolayca görebilirsiniz. Eklenti sayfası
3. Debug Bar
Kod geliştiriciler için özel hazırlanmış bir hata gösterim panelidir. Özellikle sorgu detaylarını anlık görmek isteyenler için idealdir.
WordPress Hatalarını Ayıklarken Dikkat Edilmesi Gerekenler
Yedek Alın: Herhangi bir kod değişikliğinden önce mutlaka tam site yedeği alın.
Canlı Sitelerde Gizlilik: Hataları doğrudan ekrana bastırmak yerine log dosyasına yazdırmak daha güvenlidir.
Kodlama Standartları: Hataların büyük kısmı PHP sürüm farklarından kaynaklanır. Kodlarınızın WordPress Coding Standards ile uyumlu olduğuna emin olun.
En Sık Karşılaşılan WordPress Hata Tipleri
| Hata Türü | Açıklama |
|---|---|
Notice | Değişken atanmamış ama kullanılıyor |
Warning | Kod çalışır ama hatalı parametre içerir |
Fatal Error | Kod tamamen durur, genellikle eksik fonksiyon kaynaklıdır |
Deprecated | Geçerliliğini yitirmiş bir fonksiyon ya da yapı kullanılıyor |
WordPress üzerinde hata ayıklama, özellikle geliştiriciler ve site yöneticileri için vazgeçilmez bir tanılama yöntemidir. Kodlama sırasında veya bir sorunla karşılaştığınızda, bu özelliği kullanarak problemin kaynağını hızlıca tespit edebilir ve çözebilirsiniz.
Karmaşık sistemlerde veya eklenti yoğun sitelerde, sadece hata mesajlarını değil sistemin genel davranışlarını da izlemek için debug.log, Query Monitor gibi araçları kullanmak profesyonel çözümler sunar.
Unutmayın, hata ayıklama süreci yalnızca hataları düzeltmek için değil, aynı zamanda daha sağlam, hızlı ve güvenli bir sistem kurmak için de önemlidir.
Diğer Bloglarımızdan: Php Max İnput Değeri Artırma
