WordPress beyaz ekran hatası

Bu hata neden oluşur?

Nedenler, sahada karşılaştığımız sıklığa göre sıralıdır.

1. 01

   PHP bellek limiti yetersiz

   Çok sık

   Sunucudaki PHP, sayfanın isteyebileceği belleği karşılayamadığında script yarıda durur ve hiçbir çıktı üretmez; sonuç tamamen boş bir sayfa olur.

2. 02

   Eklenti çakışması ya da hatalı eklenti

   Çok sık

   Yakın zamanda güncellenen ya da eklenen bir eklenti PHP kodunda ölümcül hataya yol açar. WP_DEBUG_DISPLAY kapalıyken bu hata ekrana yansımaz, sadece boş sayfa görünür.

3. 03

   Tema dosyasında sözdizimi hatası

   Sık

   functions.php ya da bir şablon dosyasındaki hatalı kod, sayfanın oluşturulmasını daha ilk adımda durdurur.

4. 04

   PHP sürüm uyumsuzluğu

   Sık

   Hosting sağlayıcısı PHP sürümünü yükselttiğinde, eski bir eklenti ya da tema artık kaldırılmış bir fonksiyonu çağırabilir; sonuç ölümcül hatadır.

5. 05

   Önbellek (cache) çakışması

   Ara sıra

   Sunucu ya da eklenti tabanlı önbellek, bozuk bir sürümü saklamaya devam eder; kod düzeltilse bile önbellek temizlenmeden hata görünmeye devam eder.

6. 06

   .htaccess dosyasının bozulması

   Nadiren

   Elle yapılan bir değişiklik ya da bir eklenti .htaccess dosyasını bozarsa sunucu isteği WordPress'e doğru şekilde yönlendiremez ve boş sayfa döner.

Adım adım çözüm

1. 1

   Hata ayıklama modunu açın

   wp-config.php dosyasını FTP ya da dosya yöneticisiyle açın. "/* That's all, stop editing! */" satırının üstüne aşağıdaki üç satırı ekleyin. Bu ayar hatayı ekrana değil wp-content/debug.log dosyasına yazar; ziyaretçiler boş sayfayı görmeye devam eder ama siz hatayı görürsünüz.

   php

   define( 'WP_DEBUG', true );
   define( 'WP_DEBUG_LOG', true );
   define( 'WP_DEBUG_DISPLAY', false );
   

2. 2

   debug.log dosyasını okuyun

   Sayfayı bir kez daha açıp wp-content/debug.log dosyasını indirin. Dosyanın en altındaki "PHP Fatal error" satırı, hangi eklenti ya da tema dosyasının sorunlu olduğunu ve satır numarasını gösterir.

   text

   PHP Fatal error:  Allowed memory size of 134217728 bytes exhausted
   in /wp-content/plugins/ornek-eklenti/includes/loader.php on line 58
   

3. 3

   PHP bellek limitini artırın

   Kayıtta "Allowed memory size exhausted" ifadesi geçiyorsa bellek yetersizdir. wp-config.php dosyasına şu satırı ekleyin. [bazı hosting panellerinde bu değer php.ini üzerinden de yükseltilmelidir, wp-config.php satırı tek başına yetmeyebilir].

   php

   define( 'WP_MEMORY_LIMIT', '256M' );
   

4. 4

   Eklentileri toplu devre dışı bırakın

   Sunucuya SSH erişiminiz varsa WP-CLI (WordPress'i komut satırından yönetmeye yarayan araç) ile tüm eklentileri kapatın; bu komut veritabanı içeriğini değil yalnızca eklenti durumunu değiştirir. FTP erişiminiz varsa wp-content/plugins klasörünü yeniden adlandırmanız da aynı etkiyi yapar; işlemden önce klasörün bir kopyasını alın.

   bash

   wp plugin deactivate --all
   

5. 5

   Temayı varsayılan bir temayla değiştirin

   Sorun eklentilerde çıkmadıysa aktif temada olabilir. WP-CLI ile güncel bir varsayılan temaya geçin. [sunucuda kurulu varsayılan tema adı farklı olabilir, wp theme list ile kontrol edin].

   bash

   wp theme activate twentytwentyfour
   

6. 6

   .htaccess dosyasını sıfırlayın

   Dosya Yöneticisi'nden mevcut .htaccess dosyasını indirip yedekleyin, ardından içeriğini WordPress'in varsayılan kurallarıyla değiştirin. Yönetim paneline erişebiliyorsanız Ayarlar › Kalıcı Bağlantılar sayfasını açıp Kaydet'e basmak dosyayı otomatik olarak yeniden oluşturur.

   apache

   # BEGIN WordPress
   <IfModule mod_rewrite.c>
   RewriteEngine On
   RewriteBase /
   RewriteRule ^index\.php$ - [L]
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteRule . /index.php [L]
   </IfModule>
   # END WordPress
   

7. 7

   Çekirdek dosyalarını yeniden indirin

   Yukarıdaki adımlar sonuç vermediyse WordPress çekirdek dosyaları bozulmuş olabilir. İşlemden önce mutlaka tam yedek alın; ardından içerik dosyalarına dokunmadan çekirdeği yeniden indirip bütünlüğünü doğrulayın.

   bash

   wp core download --skip-content --force
   wp core verify-checksums
   

Hangi sürümlerde görülüyor?

Çözüldüğünü nasıl anlarsınız?

• Site ön yüzü (ana sayfa, yazı, sayfa) hatasız açılıyor.
• wp-admin paneline normal giriş bağlantısıyla erişilebiliyor.
• wp-content/debug.log dosyasına yeni bir "PHP Fatal error" satırı düşmüyor.
• Devre dışı bırakılan eklenti ve tema tek tek tekrar açıldığında site çalışmaya devam ediyor.

Ne zaman uzmana başvurmalı?

Hata kaydını okuyup sorunlu dosyayı bulduysanız ama düzeltemiyorsanız ya da yedek almadan işlem yapmak istemiyorsanız bu noktada durmanızı öneririz. Hata Ayıklama ve Onarım hizmetimizde debug.log dosyasını inceleyip sorunlu eklenti, tema ya da sunucu ayarını tespit ediyor; siteyi veri kaybı olmadan tekrar çalışır hale getiriyoruz. Site tamamen erişilemez durumdaysa Acil Müdahale hizmetimiz daha hızlı bir başlangıç noktası olabilir.

İlgili sayfalar: Hata Ayıklama ve Onarım · Bu sitede kritik bir hata oluştu · Acil Müdahale · Ücretsiz hız testi

Sık sorulanlar

Kaynaklar

• WordPress Debugging (Resmî Dokümantasyon)
• PHP memory_limit Ayarı
• Apache mod_rewrite Dokümantasyonu