WordPress’te Hata Ayıklama Modu Nasıl Etkinleştirilir

Hata ayıklama modunu etkinleştirmek, WordPress kurulumunuzdaki bir dosyayı düzenlemeyi gerektirir. Basittir, ancak sitenin bozulmasını önlemek için dikkatli yapılmalıdır. Aşağıda, bunu doğru şekilde nasıl yapacağınıza dair adım adım talimatlar bulacaksınız.

Etkinleştirildikten sonra, hataları kaydedebilir, bunları ziyaretçilerden gizleyebilir ve WordPress’in hata ayıklama bilgilerini nasıl işlediğini kontrol edebilirsiniz. Bu özellikle, hataların kaydedilmesini ancak herkese gösterilmemesini istediğiniz canlı sitelerde önemlidir.

wp-config.php Dosyasını Bulma

Hata ayıklama modunu etkinleştirmenin ilk adımı wp-config.php dosyasını bulmaktır. Bu dosya, WordPress kurulumunuzun kök klasöründe bulunur; burada wp-content, wp-includes ve wp-admin klasörlerini de görebilirsiniz. Dosyaya FTP programı, barındırma kontrol panelinizin dosya yöneticisi veya geliştirme sunucusunda çalışıyorsanız yerel erişim ile ulaşabilirsiniz.

Değişiklik yapmadan önce bu dosyanın yedeğini almanız önerilir. Eksik bir karakter bile sitenizin çalışmamasına neden olabilir, bu yüzden yedekleme, dosyayı hemen geri yüklemenizi sağlar. Dosyayı bulduktan sonra bir metin düzenleyicide açın ve yapılandırmayı düzenlemeye hazırlanın.

WP_DEBUG’u Etkinleştirme

wp-config.php dosyası içinde aşağıdaki gibi bir satır görene kadar kaydırın: define( 'WP_DEBUG', false );. Bu satır, hata ayıklama modunun etkin olup olmadığını kontrol eder. Varsayılan olarak, WordPress güvenlik ve performans nedenleriyle hata ayıklamayı devre dışı bırakır. Hata ayıklamayı etkinleştirmek için, değeri false’dan true’a çevirmeniz yeterlidir.

Doğru satır şu şekilde görünmelidir: define( 'WP_DEBUG', true );. Dosyayı kaydettikten sonra WordPress, web sitenizin tamamında PHP uyarılarını, bildirimlerini ve hata mesajlarını anında göstermeye başlayacaktır. Bu, sorunlu eklentileri, temaları veya özel kodları belirlemenizi sağlar.

Hata Kaydı için WP_DEBUG_LOG Kullanma

Ekranda hata göstermek geliştirme sırasında faydalı olabilir, ancak her zaman pratik değildir. Uzun vadeli izleme için WP_DEBUG_LOG’u etkinleştirebilirsiniz. Bunu yapmak için, WP_DEBUG sabitinin hemen altına şu satırı ekleyin: define( 'WP_DEBUG_LOG', true );. Bu, tüm hataları wp-content dizini içindeki debug.log dosyasına kaydedecektir.

Bir kayıt dosyasına sahip olmak, belirli zamanlarda meydana gelen veya doğrudan ekranda yeniden oluşturamayacağınız hataları izlemek için özellikle faydalıdır. Ayrıca, geliştiricilere veya destek ekiplerine siteye doğrudan erişim vermeden dosyayı paylaşmanıza olanak tanır.

Hataları Ziyaretçilerden Gizleme

WordPress siteniz yayında ise ziyaretçilerin ham hata mesajlarını görmesini istemezsiniz. Bu durumda, ön yüzde hata görüntülemeyi devre dışı bırakmak için başka bir ayar ekleyebilirsiniz: define( 'WP_DEBUG_DISPLAY', false );. Bu, hataların kaydedilmeye devam etmesini ancak kullanıcıya gösterilmemesini sağlar.

Ayrıca, bu davranışı pekiştirmek için @ini_set( 'display_errors', 0 ); ekleyebilirsiniz. Bu kombinasyon, sitenizin profesyonel ve güvenli kalmasını sağlarken, yöneticiler ve geliştiriciler için gerekli bilgilerin hata ayıklama günlüğünde mevcut olmasını sağlar.

Gelişmiş Hata Ayıklama: SCRIPT_DEBUG

JavaScript ve CSS ile çalışan geliştiriciler için WordPress ek bir sabit sunar: define( 'SCRIPT_DEBUG', true );. Varsayılan olarak, WordPress küçültülmüş (minified) sürümlerini yükler. Script debugging etkinleştirildiğinde WordPress, incelenmesi ve hata ayıklanması daha kolay olan tam, küçültülmemiş sürümleri yükler.

Bu ayar, tema veya eklenti geliştiren ve script ile stillerin davranışlarını izlemek isteyen geliştiriciler için çok değerlidir. Genel kullanıcılar için genellikle gerekli değildir, ancak frontend sorunlarını çözmeye çalışan geliştiriciler için büyük fark yaratabilir.

Özetle, WordPress hata ayıklama modunu etkinleştirmek, sitenizi teşhis etmek ve bakımını yapmak için basit ama güçlü bir yöntemdir. wp-config.php dosyasını düzenleyerek hataları görüntüleyebilir, loglara kaydedebilir ve sorunlar sırasında bile sitenizi profesyonel gösterebilirsiniz. Doğru şekilde kullanıldığında, hata ayıklama modu WordPress’i güvenli, istikrarlı ve geliştirici dostu tutmanın en önemli araçlarından biridir.