Beyaz sayfa hatası (White Screen of Death)
WordPress’te beyaz sayfa hatası genelde ekranda hiçbir şey görünmemesi veya sadece boş beyaz bir sayfa çıkmasıdır. Eski usul kural şudur: önce hata mesajını görünür hale getir, sonra kaynağı izole et. Çünkü beyaz sayfa çoğu zaman PHP tarafında fatal error, bellek limiti aşımı, bozuk eklenti/tema dosyası veya yanlış PHP sürümü uyumsuzluğu yüzünden oluşur.
İlk iş, hatayı “gizlemek” yerine loglamaktır. Canlı sitede ekrana basmak istemiyorsan loga yazdırırsın. wp-config.php içine aşağıdaki ayarları ekleyip sayfayı yeniden denersin. Bu sayede “beyaz” yerine hata kaydı alırsın.
// wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);
Bu ayarla hata kaydı genellikle wp-content/debug.log dosyasına düşer. Logda “Allowed memory size…” görürsen sorun bellek limitidir. WordPress’te bazen admin panel açılır ama ön yüz beyaz olur; ya da tam tersi. Bu, temanın bir dosyasındaki fatal error veya bir eklentinin sadece belirli hook’larda patlaması demektir.
Bellek yetmiyorsa önce WordPress tarafında limit yükseltirsin, sonra sunucu tarafında gerçek limitleri kontrol edersin. wp-config.php içine şu satırları eklemek çoğu kurulumda hızlı çözüm olur.
// wp-config.php
define('WP_MEMORY_LIMIT', '256M');
define('WP_MAX_MEMORY_LIMIT', '512M');
Yine de asıl sınır PHP tarafındaysa php.ini veya panelden memory_limit artırılmadan sonuç alamazsın. Paylaşımlı hostlarda bu değerler kısıtlı olabilir.
İkinci klasik adım izolasyondur. Eklentiler şüpheliyse wp-admin giremiyorsan bile FTP/File Manager ile plugins klasörünü geçici olarak yeniden adlandırırsın. WordPress eklentileri devre dışı kalır, site açılıyorsa suçlu eklentiyi bulursun.
/wp-content/plugins -> /wp-content/plugins.disabled
Tema kaynaklı olma ihtimalinde de aktif temayı zorla varsayılana çekmek mümkündür. wp-content/themes içinde aktif temanın klasör adını değiştirirsen WordPress otomatik olarak Twenty Twenty gibi varsayılan temaya düşer. Eğer site açılırsa tema dosyalarında syntax/fatal hata ararsın.
Beyaz sayfa bazen cache katmanından da gelebilir. Cloudflare, LiteSpeed Cache, WP Rocket gibi sistemlerde bozuk bir minify/merge çıktısı tarayıcıda “hiçbir şey yüklenmiyor” gibi davranır. Bu durumda eklentileri devre dışı bırakmak ve cache’i temizlemek hızlı teşhistir. Ayrıca PHP sürümünü de kontrol edersin. Eski tema/eklenti yeni PHP’de (8.x) deprecated/fatal üretir; tam tersi de mümkündür.
Son olarak sunucu logları eskiden beri en sağlam kaynaktır. Apache kullanıyorsan error_log, Nginx kullanıyorsan error.log sana doğrudan satırı verir. WordPress debug.log boşsa bile sunucu logu doludur. Orada “Call to undefined function”, “Parse error”, “Uncaught TypeError” gibi bir şey görürsen, artık beyaz sayfa değil net bir hedefin vardır: ilgili dosyayı düzeltmek veya güncellemek.