Sitenizi açtığınızda karşınıza boş, beyaz bir sayfa çıkıyorsa panik yapmayın. WordPress dünyasında beyaz ekran (White Screen of Death) olarak bilinen bu durum çoğunlukla bir PHP hatasından kaynaklanır ve verileriniz büyük ihtimalle yerinde durur. Güncel WordPress sürümlerinde aynı sorun genellikle Bu sitede kritik bir hata oluştu mesajıyla görünür. Bu rehberde nedeni nasıl bulacağınızı ve sırasıyla deneyebileceğiniz sekiz çözümü anlatıyoruz.
Kısaca: Beyaz ekranın en sık nedenleri hatalı bir eklenti, tema güncellemesi, PHP bellek sınırı ve PHP sürüm uyumsuzluğudur. Önce yönetici e-postanıza gelen kurtarma bağlantısını kontrol edin, ardından hata ayıklama modunu açıp hatanın kaynağını bulun. Her adımdan önce yedeğiniz olduğundan emin olun.
Önce şunlara bakın
- Sorun nerede? Yalnızca ön yüzde mi, yalnızca yönetim panelinde mi, yoksa ikisinde de mi? Bu, nedeni daraltır.
- Son ne değişti? Bir eklenti, tema ya da WordPress güncellemesi, yeni bir kod parçası veya PHP sürüm değişikliği olduysa ilk şüpheli odur.
- E-postanızı kontrol edin: WordPress, ölümcül bir hata algıladığında yönetici e-posta adresine sorunlu eklenti veya temayı belirten bir mesaj ve kurtarma modu bağlantısı gönderir. Bu bağlantıyla panele girip sorunlu eklentiyi devre dışı bırakabilirsiniz.
- Önbelleği atlayın: Sayfayı gizli pencerede açın; gördüğünüz sorun eski bir önbellek kopyası olabilir.
Bu sorulara verdiğiniz yanıtlar, aşağıdaki çözümlerden hangisiyle başlamanız gerektiğini çoğu zaman tek başına gösterir. Örneğin sorun bir eklenti güncellemesinin hemen ardından başladıysa doğrudan birinci çözüme geçebilirsiniz.
Hata ayıklama modunu açın
Beyaz ekran size hatanın ne olduğunu söylemez. Hata ayıklama modu, PHP hatalarını bir günlük dosyasına yazmanızı sağlar. Dosya yöneticisi veya FTP ile sitenin kök dizinindeki wp-config.php dosyasını açın ve /* That’s all, stop editing! */ satırından önce şu satırları ekleyin (bu satırlar dosyada zaten varsa değerlerini değiştirin):
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Sayfayı yeniden yükleyin ve wp-content klasöründe oluşan debug.log dosyasını açın. Fatal error ile başlayan satır, sorunun hangi dosyadan kaynaklandığını gösterir. Dosya yolunda plugins/eklenti-adı geçiyorsa sorun o eklentide, themes/tema-adı geçiyorsa temadadır.
Sorunu çözdükten sonra WP_DEBUG değerini false yapın ve debug.log dosyasını silin. Bu dosya, sunucunuz hakkında başkalarının görmemesi gereken bilgiler içerebilir.
Olası nedenler ve 8 çözüm
| Belirti | Muhtemel neden | İlk denenecek çözüm |
|---|---|---|
| Eklenti güncellemesinden sonra başladı | Eklenti hatası veya çakışma | Çözüm 1 |
| Tema değişikliği veya güncellemesinden sonra | Tema hatası | Çözüm 2 |
| Günlükte Allowed memory size exhausted | PHP bellek sınırı yetersiz | Çözüm 3 |
| Hosting PHP sürümünü değiştirdikten sonra | Sürüm uyumsuzluğu | Çözüm 4 |
| Yalnızca bazı ziyaretçilerde görünüyor | Önbellek | Çözüm 5 |
- Eklentileri devre dışı bırakın. Panele giremiyorsanız FTP ile wp-content/plugins klasörünün adını plugins-kapali olarak değiştirin; WordPress tüm eklentileri devre dışı bırakır. Site açılırsa klasörün adını geri alın ve eklentileri panelden tek tek açarak sorunluyu bulun.
- Varsayılan temaya geçin. wp-content/themes içindeki aktif tema klasörünün adını geçici olarak değiştirin. Sitede kurulu bir varsayılan WordPress teması varsa WordPress ona geçer. Site açılıyorsa sorun temadadır.
- PHP bellek sınırını artırın. wp-config.php dosyasına define( ‘WP_MEMORY_LIMIT’, ‘256M’ ); satırını ekleyin. Hosting paketinizin izin verdiği üst sınır bundan düşükse değişiklik etkili olmaz; hosting firmanıza danışın.
- PHP sürümünü kontrol edin. Hosting panelinden PHP sürümünü sorun başlamadan önceki sürüme alın ya da eklentilerinizin desteklediği bir sürüm seçin. Uzun vadede çözüm, eski eklentiyi güncellemek veya değiştirmektir.
- Önbelleği temizleyin. Önbellek eklentinizin, hosting panelinin ve varsa CDN hizmetinin önbelleğini temizleyin.
- Son eklenen kodu geri alın. functions.php dosyasına ya da bir kod parçacığı eklentisine yeni kod eklediyseniz onu kaldırın. Eksik bir noktalı virgül bile beyaz ekrana yol açabilir.
- .htaccess dosyasını yenileyin. Dosyanın adını .htaccess-eski yapın, site açılırsa Ayarlar > Kalıcı bağlantılar sayfasında Değişiklikleri kaydet’e basarak yeni bir dosya oluşturun.
- Çekirdek dosyaları yenileyin. Yarım kalmış bir güncelleme dosyaları bozmuş olabilir. Panele girebiliyorsanız Başlangıç > Güncellemeler ekranından yeniden yükleme yapın; giremiyorsanız wordpress.org’dan indirdiğiniz paketteki wp-admin ve wp-includes klasörlerini sunucudakilerle değiştirin. wp-content klasörüne ve wp-config.php dosyasına dokunmayın.
Hiçbiri işe yaramazsa
Yukarıdaki adımlar sonuç vermediyse son yedeğinizden geri yükleme yapmak en hızlı çözüm olabilir. Hosting firmanızın destek ekibinden sunucu hata günlüklerini (error log) isteyin; sunucu tarafındaki bir sorun da beyaz ekrana yol açabilir. Dosya izinlerinin yanlış ayarlanması da nadir ama olası bir nedendir.
Destek isterken sorunun ne zaman başladığını, en son yaptığınız değişikliği ve debug.log dosyasındaki hata satırını iletin. Bu bilgiler, sorunun çok daha hızlı çözülmesini sağlar.
Tekrar yaşamamak için
- Her güncellemeden önce yedek alın.
- Büyük güncellemeleri önce bir test kopyasında (staging) deneyin.
- Eklentileri toplu değil, tek tek güncelleyin; sorun çıkarsa kaynağı hemen bellidir.
- Kullanmadığınız eklenti ve temaları silin; ancak acil durumda geçiş yapabilmek için güncel bir varsayılan WordPress temasını kurulu tutun.
- PHP sürüm yükseltmelerini önce test kopyasında deneyin.
- Yönetici e-posta adresinin güncel olduğundan emin olun; kurtarma bağlantısı oraya gelir.
Sık sorulan sorular
Beyaz ekran verilerimi siler mi?
Genellikle hayır. Sorun kodun çalışmasındadır; yazılarınız ve ayarlarınız veritabanında durur. Yine de müdahale etmeden önce yedek almak en doğrusudur.
Yalnızca yönetim paneli beyaz görünüyor, neden?
Çoğunlukla bir eklentinin yalnızca panelde çalışan kodu veya bellek sınırı sorunun kaynağıdır. Eklentileri devre dışı bırakmak ve bellek sınırını kontrol etmek iyi bir başlangıçtır.
Kurtarma e-postası gelmedi, ne yapmalıyım?
Yönetici e-posta adresi eski olabilir ya da sunucu e-posta gönderemiyor olabilir. Bu durumda FTP ile eklenti klasörünün adını değiştirme yöntemini kullanın.
Hata ayıklama modunu açık bırakabilir miyim?
Canlı sitede önerilmez. Sorunu bulduktan sonra kapatın ve günlük dosyasını silin.
Hatayı kendiniz çözemediyseniz destek sayfamızdan bize ulaşabilirsiniz.