Siteyi açtığınızda karşınıza beyaz bir sayfa ve tek bir cümle çıkıyor: ‘There has been a critical error on this website’. Yönetim paneline girmeye çalışıyorsunuz, orada da aynı ekran. Panik yapmaya gerek yok. Modern WordPress sürümleri bu durumu düşünerek tasarlandı ve çoğu zaman sorunu birkaç dakikada çözebilirsiniz.
Bu ekran, WordPress’in bir yerde ölümcül bir PHP hatasıyla karşılaştığını ve işlemi durdurduğunu gösterir. Eskiden bu gibi durumlarda bomboş beyaz bir sayfa gelirdi. Şimdi WordPress daha anlayışlı davranıyor, hatayı yakalıyor ve site yöneticisinin e-posta adresine bir kurtarma modu (recovery mode) bağlantısı gönderiyor.
Belirti neye benziyor
Ziyaretçiler siteyi gezerken aniden bu mesajla karşılaşır. Siz yönetici olarak wp-admin’e giremezsiniz. Bazen mesaj biraz daha uzundur ve ‘bu sitede teknik bir sorun yaşanıyor’ şeklinde Türkçe de görünebilir. İçerik aynıdır: bir şey PHP tarafında patladı.
Neden oluyor
En sık rastlanan sebepler şunlar:
- Yeni kurduğunuz ya da güncellediğiniz bir eklenti mevcut WordPress sürümüyle uyumsuz.
- Temanın functions.php dosyasına eklenen bir kod parçası hata veriyor.
- Sunucudaki PHP sürümü siteniz için çok yeni ya da çok eski.
- PHP bellek sınırı dolmuş ve işlem yarıda kesilmiş.
- Bir eklenti ya da tema güncellemesi yarım kalmış.
Adım adım çözüm
İlk bakacağınız yer e-posta kutunuz. WordPress, yönetici e-postasına ‘Siteniz teknik bir sorun yaşıyor’ konulu bir ileti göndermiş olmalı. Bu iletide hangi eklentinin ya da dosyanın soruna yol açtığı çoğu zaman açıkça yazar. Alt tarafta kurtarma modu bağlantısı bulunur. O bağlantıya tıkladığınızda panele özel bir modda girersiniz ve sorunlu eklentiyi oradan devre dışı bırakabilirsiniz.
E-posta gelmediyse, spam klasörünü kontrol edin. Yine yoksa FTP ile sunucuya bağlanın. Bir FTP istemcisiyle (FileZilla gibi) sitenize girip wp-content/plugins klasörünü açın. Son eklediğiniz eklentinin klasörünü geçici olarak yeniden adlandırın, örneğin ‘eklenti-adi’ yerine ‘eklenti-adi-kapali’ yazın. Bu, eklentiyi devre dışı bırakır. Siteyi yenileyin. Açıldıysa suçluyu bulmuşsunuz demektir.
Hata hangi eklentiden geldiğini belli etmiyorsa, hatayı görünür kılın. FTP ile wp-config.php dosyasını açın ve içinde WP_DEBUG satırını bulun. Değerini true yapın:
define(‘WP_DEBUG’, true);
Bunu yaptığınızda WordPress hatanın tam metnini, dosya adını ve satır numarasını ekrana basar. Böylece sorunun hangi dosyada olduğunu doğrudan görürsünüz. İşiniz bittiğinde bu değeri tekrar false yapmayı unutmayın, çünkü ziyaretçilerin hata detaylarını görmesini istemezsiniz.
Sorun temadaysa, geçici olarak varsayılan bir temaya dönün. FTP ile wp-content/themes içindeki aktif tema klasörünü yeniden adlandırın. WordPress tema bulamayınca otomatik olarak Twenty Twenty gibi varsayılan bir temaya geçer. Site açıldıysa, hata temanızda demektir.
PHP sürümü ya da bellek sınırı sorunuysa, hosting panelinizden (cPanel, Plesk ya da benzeri) PHP sürümünü değiştirebilirsiniz. Çoğu güncel WordPress sitesi PHP 8.0 ve üzeriyle rahat çalışır ama bazı eski eklentiler eski sürüm ister. Bellek sınırını artırmak için wp-config.php içine şu satırı ekleyebilirsiniz:
define(‘WP_MEMORY_LIMIT’, ‘256M’);
Tekrar yaşamamak için
Eklenti ve tema güncellemelerini doğrudan canlı sitede yapmak yerine önce bir test (staging) ortamında denemek, bu ekranla az karşılaşmanın en kolay yolu. Güncellemeden önce tam yedek almak da sizi birçok dertten kurtarır. functions.php’ye kod eklerken bir çocuk tema kullanın, böylece tema güncellenince yaptığınız değişiklikler kaybolmaz.
Bu hatayı ilk gördüğünüzde korkutucu gelebilir ama aslında WordPress size yol gösteriyor. Kurtarma modu e-postası ve WP_DEBUG çoğu durumda yeter. Takıldığınız bir nokta olursa, hostinginizin destek ekibi de hata günlüklerine bakıp size yardımcı olabilir.
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