Sitenizi ziyaret ettiğinizde bomboş bir ekran ya da ‘Bu sitede ölümcül bir hata oluştu’ yazan kısa bir mesaj görüyorsanız PHP tarafında bir şey patlamış demektir. Yönetim paneline bile giremediğiniz olur. Panik yapmaya gerek yok, bu hata neredeyse her zaman belli bir eklenti, tema ya da sürüm uyumsuzluğundan kaynaklanır ve kaynağı bulunduğunda çözümü nettir.
Belirtiler ne söyler
Eski WordPress sürümlerinde bu durum tamamen beyaz bir sayfayla çıkardı, buna beyaz ölüm ekranı deniyordu. Daha yeni sürümler ise ziyaretçiye nazik bir uyarı, yöneticiye de e-posta gönderir. O e-postada çoğu zaman sorunun hangi eklentiden geldiği yazar. Önce gelen kutunuza bakın, iş bazen orada biter.
Olası sebepler
- Yeni kurduğunuz ya da güncellediğiniz bir eklentinin siteyle uyuşmaması
- Tema dosyalarının bozulması ya da hatalı bir kod parçası
- Sunucudaki PHP sürümünün eklenti veya temanın beklediğinden eski ya da çok yeni olması
- functions.php içine elle eklenmiş, yazım hatası olan bir kod
Hatayı görünür yapın
İlk iş hatanın ne olduğunu okumak. FTP ya da hosting dosya yöneticinizle wp-config.php dosyasını açın. İçinde define(‘WP_DEBUG’, false); satırını bulun, değeri true yapın. Artık sayfada hatanın hangi dosyada ve hangi satırda oluştuğu yazacak. O yol size doğrudan sorumluyu gösterir. Mesajda /plugins/eklenti-adi/ gibi bir yol varsa suçlu o eklentidir.
Adım adım çözüm
- FTP ile bağlanın, /wp-content/plugins/ klasörüne girin. Hatada adı geçen eklentinin klasörünü yeniden adlandırın, örneğin sonuna _kapali ekleyin. WordPress o eklentiyi bulamayınca otomatik devre dışı bırakır. Siteniz geri geldiyse sorun o eklentiydi.
- Hangi eklentiden geldiğini bilmiyorsanız plugins klasörünün tamamını geçici olarak yeniden adlandırın. Tüm eklentiler kapanır. Site açılıyorsa klasörü eski adına döndürüp eklentileri panelden tek tek açarak sorunluyu yakalayın.
- Sorun temadaysa /wp-content/themes/ içine geçin ve geçici olarak varsayılan bir temaya dönün. Aktif temanın klasörünü yeniden adlandırmanız yeterli, WordPress yedek temaya geçer.
- Hata PHP sürümüyle ilgiliyse hosting panelinizden PHP sürümünü uyumlu bir değere alın. Çok eski bir sürümdeyseniz yükseltin, çok yeni bir sürüm eski bir eklentiyi bozuyorsa bir kademe geri alın.
- functions.php içine elle kod eklediyseniz son eklediğiniz satırları geri çıkarın. Buraya yapılan müdahaleler en sık kaynaklardan biridir.
Log dosyasına bakmak
WP_DEBUG’u açarken debug kaydını dosyaya yazdırmak da işe yarar. wp-config.php içine define(‘WP_DEBUG_LOG’, true); eklerseniz hatalar /wp-content/debug.log dosyasına birikir. Ekranda görünmesini istemiyorsanız WP_DEBUG_DISPLAY değerini false yapıp sadece loga yazdırabilirsiniz. Bu dosya ziyaretçiye bir şey göstermeden sorunu kayıt altına alır.
Yönetim paneline hiç giremiyorsanız
Bazen hata o kadar yayılır ki panele bile ulaşamazsınız, hem ön yüz hem arka yüz beyaz kalır. Böyle durumlarda tek yolunuz FTP ya da hosting dosya yöneticisidir. Panel üzerinden hiçbir şey kapatamayacağınız için eklenti ve tema klasörlerini doğrudan dosya sisteminden yeniden adlandırmanız gerekir. Panel geri geldiğinde içeriğinize bir şey olmadığını görürsünüz, çünkü bu hata yazılarınızı değil çalışan kodu etkiler. Veritabanınıza dokunmadığınız sürece yazılarınız yerinde durur.
Bir daha başına gelmesin
Tema dosyalarını doğrudan düzenlemek yerine bir çocuk tema kullanın. Böylece ana tema güncellendiğinde değişiklikleriniz silinmez ve bir hata yaptığınızda ana temayı bozmamış olursunuz. Eklenti ve temaları güncellemeden önce yedek almayı alışkanlık edinin. Büyük güncellemeleri önce bir test ortamında deneyin. İşiniz bittiğinde WP_DEBUG değerini tekrar false yapmayı unutmayın, açık kalması ziyaretçilere teknik detayları gösterebilir.
Çoğu durumda bu yöntemle hatayı on dakika içinde yalıtıp çözersiniz. Takılırsanız debug.log içeriğini saklamanız, destek alırken size zaman kazandırır.
Bu işleri kendiniz yapmak yerine profesyonel destek isterseniz, WordPress bakım ve teknik destek hizmetime göz atabilirsiniz.
Bu konunun tüm rehberi: WordPress Hataları ve Çözümleri