7/24 Türkçe destek:[email protected]Sistem durumuDestek talebi

WordPress Hata Ayıklama (WP_DEBUG) Nasıl Açılır?

Okuma süresi: 2 dk

Kısa yanıt: wp-config.php dosyasında “stop editing” (düzenlemeyi bırakın) yorum satırının üstüne WP_DEBUG ve WP_DEBUG_LOG değerlerini true, WP_DEBUG_DISPLAY değerini false olarak ekleyin. Hatalar ziyaretçilere gösterilmeden wp-content/debug.log dosyasına yazılır.

Bu rehber kimin için: Hata kaynağını arayan yöneticiler ve geliştiriciler · Gereken süre: 5 dakika · Seviye: Orta

Hata ayıklama modu, WordPress’in ve eklentilerin ürettiği hataları, uyarıları ve kullanımdan kalkmış işlev bildirimlerini kaydeder. Hataları ekranda göstermek dosya yollarını ve bazen veritabanı bilgilerini ziyaretçilere açabileceği için canlı sitelerde yalnızca kayda yazmayı tercih edin.

Hata ayıklamayı açma

  1. wp-config.php’yi açın: Dosya Yöneticisi’nde public_html içindeki wp-config.php dosyasına sağ tıklayıp “Düzenle”yi seçin; önce bir kopyasını alın.
  2. Satırı bulun: İngilizce kurulumlarda “That’s all, stop editing! Happy publishing.”, Türkçe kurulumlarda bunun çevirisi olan ve “Hepsi bu kadar” diye başlayan yorum satırını bulun. Bu satır yoksa ayarları, dosyanın sonundaki wp-settings.php satırının üstüne ekleyin.
  3. Ayarları ekleyin: Bu satırın hemen üstüne aşağıdaki üç satırı ekleyin; dosyada zaten define('WP_DEBUG', false); varsa onu değiştirin.
  4. Hatayı tekrar üretin: Sorunlu sayfayı açın veya işlemi tekrarlayın.
  5. Kaydı okuyun: wp-content/debug.log dosyasını açın; en alttaki satırlar en yeni kayıtlardır.
  6. Kapatın: İşiniz bitince WP_DEBUG değerini false yapın ve debug.log dosyasını silin.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Kayıttaki satırları yorumlama

“PHP Fatal error” siteyi durduran hatadır ve öncelikle bu satırlara bakılır. “Warning” ve “Notice” satırları genellikle siteyi bozmaz ama eklentinin güncel olmadığını gösterebilir. “Deprecated” bildirimleri, ileride kaldırılacak bir işlevin kullanıldığını gösterir. Satırdaki dosya yolu (wp-content/plugins/… veya themes/…) sorumlu bileşeni söyler.

Hâlâ çözülmediyse

debug.log dosyası herkese açık bir klasörde durduğu için bilgi sızdırabilir; işiniz bitince mutlaka silin veya WP_DEBUG_LOG değerine wp-content dışında bir dosya yolu verin. Kayıtlar sizi bir sunucu sorununa yönlendiriyorsa satırları destek talebine ekleyin. Hata ayıklamayı canlı siteyi etkilemeden yapmak için sitenizin bir hazırlık (staging) kopyasını kullanabilirsiniz; WordPress hosting paketlerimiz haftalık otomatik yedekle gelir.

Sık sorulan sorular

debug.log dosyası oluşmuyor.

wp-content klasörünün yazılabilir olduğunu (izin 755) kontrol edin ve ayarları “Hepsi bu kadar” satırının üstüne eklediğinizden emin olun.

SCRIPT_DEBUG ne işe yarar?

WordPress’in sıkıştırılmamış JavaScript ve CSS dosyalarını yüklemesini sağlar; yalnızca çekirdek betik sorunlarını incelerken gerekir.

İlgili rehberler