WordPress Hata Ayıklama Modu Nasıl Etkinleştirilir?

Hata ayıklama modu, WordPress’in arka planda neler olup bittiğini görmenizi sağlayan bir araçtır. Normalde WordPress, kullanıcı deneyimini bozmamak için hataları gizler. Ancak bir geliştirici veya site sahibi olarak, bu hataları görmek ve düzeltmek istersiniz. Bu rehberde, WP Debug Mode yani WordPress hata ayıklama modu nasıl etkinleştirilir, hangi durumlarda kullanılır ve en önemlisi güvenli bir şekilde nasıl yönetilir sorularının yanıtını öğreneceksiniz.

Hata Ayıklama Modu Nedir?

WordPress hata ayıklama modu (WP_DEBUG), sitenizde oluşan PHP hatalarını, uyarılarını ve bildirimlerini ekrana yazdıran bir özelliktir. Normalde bu hatalar gizlidir, ancak debug modunu açtığınızda tüm teknik sorunlar görünür hale gelir.

WordPress’te karşılaşabileceğiniz hatalar çok çeşitlidir, ancak WordPress bu hataları izleyebilmeniz için yerleşik bir işlev sunmaz. Hata ayıklama modu olmadan, sitenizde bir şeyler ters gittiğinde sadece sonuçları görürsünüz: beyaz ekran, eksik özellikler, yavaş yükleme… Ancak nedenini bilemezsiniz. Debug mod sayesinde: Güncel olmayan PHP kodlarını fark edersiniz, hangi eklentinin veya temanın soruna yol açtığını anlarsınız, kod hatalarını tespit edip düzeltebilirsiniz, site performansını etkileyen sorunları bulursunuz.

WordPress, hata ayıklama için tek bir ayar değil, birbirleriyle çalışan birkaç farklı sabit (constant) kullanır. Her birinin farklı bir görevi vardır ve doğru kombinasyonu kullanmak, verimli bir hata ayıklama süreci için oldukça önemlidir:

• WP_DEBUG– Ana anahtardır. PHP hata raporlamasını etkinleştirir. true olarak ayarlandığında, WordPress tüm PHP hatalarını, uyarılarını ve bildirimlerini gösterir.
• WP_DEBUG_LOG– Hataları ekrana yazdırmak yerine bir log dosyasına kaydeder. Dosya wp-content/debug.log olarak oluşturulur.
• WP_DEBUG_DISPLAY– Hataların ekrana yazdırılıp yazdırılmayacağını kontrol eder. false yaparsanız hatalar görünmez ama log’a kaydedilmeye devam eder.
• SCRIPT_DEBUG– WordPress ve eklentilerin sıkıştırılmış (.min) yerine tam sürüm JavaScript ve CSS dosyalarını yüklemesini sağlar.

Bu sabitleri birlikte veya ayrı ayrı kullanabilirsiniz. Örneğin, bir geliştirme ortamında hepsini etkinleştirebilirken, canlı sitede sadece WP_DEBUG_LOG kullanmayı tercih edebilirsiniz.

Hata Ayıklama Modunu Etkinleştirme: Manuel Yöntem

Hata ayıklama modunu etkinleştirmek için wp-config.php dosyasını düzenlemeniz gerekir. Bu dosya, WordPress’in en önemli yapılandırma dosyasıdır ve kullanırken çok dikkatli olmanız gerekir. Gelin adım adım ilerleyelim:

1. İşlemden önce mutlaka sitenizin bir yedeğini alın.
2. Ardından cPanel’de otum açın. (cPanel’e erişiminiz yoksa bir Filezilla gibi bir FTP istemcisiyle devam edebilirsiniz).
3. cPanel’e giriş yaptıktan sonra Dosya Yöneticisi simgesine tıklayın.
4. public_html dizininde bulunan wp-config.php dosyasına sağ tıklayın, ardından Düzenle seçeneğine tıklayın.
5. Sayfayı kaydırarak /* That’s all, stop editing! Happy publishing. */ satırını bulun ve hemen üst kısmına aşağıdaki kodları ekleyip değişiklikleri kaydedin:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );
@ini_set( 'display_errors', 0 );

📌 NOT: Eğer wp-config.php dosyanızda define( ‘WP_DEBUG’, false); satırı ya da diğer satırlar varsa, false/true değerlerini yukarıdaki kod satırlarında belirtildiği gibi düzenlemeniz yeterli olur.

⚠️ Kodları ekleyip değişiklikleri kaydettikten sonra hata ayıklama günlüğündeki hataları görüntülemek için public_html/wp-content/debug.log yolunu izleyin. Tüm hata kayıtları debug.log dosyanıza kaydedilir. Hataları bulup düzelttikten sonra hata ayıklama modunu MUTLAKA DEVRE DIŞI BIRAKIN. Bunun için de wp-config.php dosyanıza eklediğiniz kodların kodları silebilirsiniz.

Eklenti ile WordPress Hata Ayıklama Modunu Etkinleştirme

Çekirdek dosyaları düzenlemek istemiyorsanız bir eklenti ile hata ayıklama modunu etkinleştirebilirsiniz.

• Öncelikle WordPress yönetim panelinizden Eklentiler>Yeni Ekle bölümüne gidin.
• Arama kutusuna WP Debugging yazın ve eklentiyi kurup etkinleştirin.
• Eklenti kurulduktan sonra otomatik olarak wp-config.php dosyanızda aşağıdaki ‘sabitleri’ etkinleştirir:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );

• Şimdi eklenti ayarlarına gidin (WordPress yönetim paneli sol menüdeki Araçlar bölümünün altında eklentiyi göreceksiniz. Ayarlarını yapmak için tıklayın).
• Alt kısımdaki “Set WP-DEBUG to true” seçeneğini ve hemen altında bulunan “Set WP_DEBUG_DISPLAY to false, default is true” seçeneğini işaretleyip değişikleri kaydedin.

• Şimdi hataları görüntülemek için Debug Quick Look menü öğesine tıklayabilirsiniz. Hatalar bir süre sonra günlükte listelenmeye başlayacaktır.

• Eklenti çekirdek dosyalarınıza girmeden sitenizde hata ayıklamanın en kullanışlı yoludur. Bununla birlikte, işiniz bittiğinde hata ayıklama modunu etkisizleştirmek için eklentiyi silmeniz yeterli olur.