WordPress’in yönetimi nispeten kolay olsa da, sorun giderme hataları, kullanıcıları için oldukça yaygın bir sorundur. Onlarla başa çıkmak genellikle zor değildir – tek gereken biraz pratik yapmaktır. Her WordPress hata giderme işleminin ilk adımı, hata günlüğünü almaktır.
Hata günlüğü, sitenizin arkasındaki kodla ilgili tüm hataları, uyarıları ve bildirimleri içerir. Bazen, soruna neden olan tam dosyayı ve kod satırını belirlemenize yardımcı olabilir. Hata günlüğü, “beyaz ölüm ekranı” gibi görünüşte çözülemeyen hataları çözmek için ipuçları da sağlayabilir.
Bununla birlikte teknoloji konusunda bilgili değilseniz, hata günlüğünü anlamak oldukça zor olabilir. Teknolojiden anlayan biri olmak için bir yerden başlamalısınız – o yüzden size WordPress’te hata günlüğünü nasıl açacağınızı ve alacağınızı göstererek başlayalım.
WP-Config Dosyanızda WordPress Hata Günlüklerini Ayarlama
wp-config.php dosyası, önemli bir WordPress yapılandırma dosyasıdır. Biraz düzenleyerek, WordPress varsayılan hata ayıklamasını etkinleştirecek ve hataları göstereceksiniz. Bunu bir FTP istemcisi veya cPanel aracılığıyla yapabilirsiniz.
Bir FTP İstemcisi Kullanmak
Sunucu dosyalarınızda herhangi bir düzenleme yapmak için ön koşul, dosya izinlerini uygun şekilde ayarlamaktır. wp-config.php dosyası için önerilen izinler 440 veya 400’dür. Bu durum yalnızca dosyaları okumanıza izin verildiği anlamına gelir. Bir hata günlüğü elde edebilmek için, dosya izinlerini geçici olarak 644 veya 666 olarak değiştirmeniz gerekir. Açıklama için 644, yönetici kullanıcılara okuma ve yazma/düzenleme izinleri verirken, geri kalan kullanıcılar yalnızca okuma izinlerine sahiptir. 666 değeri, yukarıda belirtilen izin türlerinin her ikisini de tüm kullanıcılara verir.
Devam etmek için bir FTP istemcisine ve wp-config.php dosyasını düzenleme bilgisine ihtiyacınız var. FTP kimlik bilgilerinizi kullanarak sunucuya bağlanarak başlayın. Kök WordPress dizininize gidin. wp-config.php dosyasını bulun, üzerine sağ tıklayın ve “Dosya izinleri” seçeneğini seçin.
Önerilen sayısal değerlerden birini (644 veya 666) manuel olarak girin ve “Tamam”a tıklayın.
İzinleri değiştirdikten sonra, kök dizine geri dönün, wp-config.php dosyasına sağ tıklayın ve “Görüntüle/Düzenle” seçeneğini seçin.
Dosyayı bir metin düzenleyici kullanarak açın ve şu kod satırını ekleyin:
define('WP_DEBUG', true);
yukarıda /* Hepsi bu kadar, düzenlemeyi durdurun! Mutlu bloglama. */.
Eğer define('WP_DEBUG', false); satır zaten mevcut, yalnızca false değerini true olarak değiştirin.
Değişiklikleri kaydedin ve düzenlenen dosyayı WordPress kök dizininize yükleyin. Bu durum şu anda sunucunuzda bulunan dosyayı geçersiz kılacaktır.
cPanel üzerinden
wp-config.php dosyasını düzenlemek için cPanel’i de kullanabilirsiniz. Kimlik bilgilerinizi kullanarak cPanel’de oturum açın ve “Dosya Yöneticisi”ne tıklayın.
Soldaki WordPress kurulumunuzun kök dizinine gidin, wp-config.php dosyasını bulun, sağ tıklayın ve “İzinleri Değiştir” seçeneğini seçin.
Uygun onay kutusunu işaretleyerek (yönetici) kullanıcı için hem okuma hem de yazma izinlerini etkinleştirdiğinizden emin olun. Daha sonra “İzinleri Değiştir” i tıklayın.
Daha sonra wp-config.php dosyasına bir kez daha sağ tıklayın ve “Düzenle” seçeneğini seçin.
Dosya varsayılan cPanel düzenleyicisinde açılacaktır, bu nedenle yalnızca şunu eklemeniz gerekir: define('WP_DEBUG', true); yukarıda /* That's all, stop editing! Happy blogging. */ wp-config dosyasındaki kod satırı.
Dosya zaten aşağıdaki satırı içeriyorsa define('WP_DEBUG', false); yanlışı true olarak değiştirin ve ekranınızın sağ üst köşesindeki “Değişiklikleri Kaydet”e tıklayın.
Görüntüleme Hataları Nasıl Yönetilir?
Hataları başarıyla görüntülediğinizde, hem arka uçta hem de ön uçta sayfalarınızda görünürler. Siteniz geliştirme aşamasında olmadığı sürece, hataları canlı olarak göstermek iyi bir fikir değildir. Bunun yerine, bunları tek bir dosya olarak kaydetmeli ve sitenizden gizlemelisiniz. Bu durum dosyayı daha sonra görüntülemenize ve istediğiniz zaman hataları gidermenize olanak tanır.
Bunu yapmak için bu kodu wp-config.php dosyanıza ekleyin.
define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false ); @ini_set( 'display_errors', 0 );
Aşağıdaki satırın altına kodu ekleyin define('WP_DEBUG', true); ve üstünde /* That's all, stop editing! Happy blogging. */ kod satırı.
Dosyayı bir FTP istemcisi kullanarak veya cPanel aracılığıyla, önceki bölümde ortaya koyduğumuz aynı adımları izleyerek düzenleyebilirsiniz. Düzenlemeden sonra, wp-config.php dosyanız bu şekilde görünmelidir.
define( ‘WP_DEBUG_LOG’, true ); ekleyerek WordPress’i tüm hata mesajlarını tek bir dosyada depolamaya zorluyoruz. Varsayılan olarak, bu dosya debug.log olarak adlandırılır ve WordPress-root/wp-content/ dizininizde bulunur. Hata mesajlarını, oluşturduğunuz başka bir dosyada da saklayabilirsiniz. Bu durumda, “define( ‘WP_DEBUG_LOG’, true );” yerine true değerini değiştirin. dosyanın yoluna. Örneğin:
define( 'WP_DEBUG_LOG', path-to-your-site/wp-content/error.log );
Ayrıca WP_DEBUG_DISPLAY, hata mesajlarının ekranda gösterilip gösterilmeyeceğini belirler. define( ‘WP_DEBUG_DISPLAY’, false ); ekleyerek WordPress’e mesajları ekranınızdan gizlemesini söylersiniz, fakat bunlar yine de belirtilen dosyaya yazdırılır. Ayrıca @ini_set( ‘display_errors’, 0 ); eklerseniz bu, PHP’niz için hata yazdırmayı devre dışı bırakır ve kullanıcıların bunları ön uçta görememesini sağlar.
Hata Günlüğünü Alma
Gösterilen ve uygun hata günlüğü dosyasına başarıyla yazılan hatalar ile geriye kalan tek şey, hata mesajlarını incelemek ve daha ileri adımlar atmak.
debug.log Dosyasını Manuel Olarak İndirme
Günlük dosyasını indirmek için sunucunuza bağlanın, kök WordPress klasörünüze gidin ve wp-content’e tıklayın. İçinde debug.log dosyasını bulun, üzerine sağ tıklayın ve “İndir” e basın.
Dosyayı masaüstünüze kaydedin. Daha sonra önceki düzenlemeleri geri aldığınızdan emin olun. Bu durum girdiğiniz kodu kaldırmayı ve wp-config.php dosyasındaki izinleri 440 veya 400 olarak değiştirmeyi içerir. İsterseniz, bunu hataları çözdükten sonra yapabilirsiniz.
Son olarak kaydedilen debug.log dosyasını bir metin düzenleyici ile açın ve yazılan hata mesajlarını kontrol edin. Uzmanlık seviyenize bağlı olarak hataları kendiniz çözebilir veya bir geliştirici ile çalışabilirsiniz.
Daha Gelişmiş Hata Ayıklama Özellikleri
Ayrıca bazı daha gelişmiş hata ayıklama olanaklarına da göz atacağız. Aşağıdaki kod, yukarıdaki wp-config.php dosyasına eklenmelidir. /* That's all, stop editing! Happy blogging. */ astar.
1. tanımla(‘SCRIPT_DEBUG’, doğru);
Bu kod, WordPress’i CSS ve JS dosyalarının küçültülmemiş sürümlerini kullanmaya zorlar; bu, özellikle CSS ve JS dosyalarınızda bulunan değişikliklerde ve/veya hatalarda hata ayıklamak için kullanışlıdır.
2. tanımla(‘CONCATENATE_SCRIPTS’, yanlış);
CONCATENATE_SCRIPTS sabitini false olarak ayarlayarak, WordPress’i tüm komut dosyalarını ayrı ayrı yüklemeye zorlarsınız. Bu durum hatalı/uyumsuz komut dosyalarının tam olarak belirlenmesi için yararlı olabilir.
2. define(‘SAVEQUERIES’, true );
Veritabanı sorunları yaşıyorsanız, çalıştırılan sorguları analiz etmek hata ayıklamaya başlamanın iyi bir yoludur. Yukarıdaki kodu girerek, $wpdb->queries dizisinde sorgu içeriğini, hangi işlevin onu çağırdığını ve ne kadar süreyle çalıştırıldığını koyacaksınız. Bu durum temanın kodunun arka uç kısmına ve tam olarak ne yaptığına daha derinden dalmanıza olanak tanır.
Daha sonra tüm sorguları okunabilir bir biçimde göstermek ve analiz etmek için aşağıdaki kodu ekleyebilirsiniz.
global $wpdb;
print("<pre>".print_r($wpdb->queries,true)."</pre>");
Fakat bu kodun sitenizin performansını etkileyeceğini unutmayın, bu nedenle kodu yalnızca hata ayıklama amacıyla kullanmanızı öneririz.
Çözüm Yolu
Bu kılavuzu izleyerek, hata günlüklerini bir dosyada gösterebilir ve güvenli bir şekilde saklayabilir, dosya izinlerini değiştirebilir ve daha ileri düzey WordPress kullanıcılarına yönelik bazı hata ayıklama özelliklerini çalıştırabilirsiniz. Bu eğitim, web sitenizin çalışma şekli hakkında daha fazla bilgi edinmenize de yardımcı olacaktır; bu nedenle, gelecekte bu talimatlara ihtiyaç duyabileceğiniz için yakınınızda tutun.