WordPress Beyaz Ekran (White Screen of Death) Hatası Nasıl Çözülür?

Tarayıcının adres çubuğuna sitenin adını yazdın, heyecanla “Enter”a bastın ve… Karşında bomboş, simsiyah bir hiçlik. Hayır şef, monitörün bozulmadı; WordPress dünyasının en ikonik korku filmi olan White Screen of Death (WSoD) yani Beyaz Ekran Hatası ile karşı karşıyasın.

Bu hatanın en berbat tarafı, hata mesajlarında genellikle neyin yanlış gittiğine dair tek bir kelime bile yazmamasıdır. Sadece bomboş bir sayfa sana bakar, sen sayfaya bakarsın. Genellikle yeni bir eklenti yüklediğinde, temanı güncellediğinde ya da sunucu PHP sürümünü kurcaladığında bu hata tetiklenir.

İyi haber: Siten silinmedi, veritabanın havaya uçmadı. Sadece arka planda bir PHP kodu ölümcül bir hata (Fatal Error) aldı ve WordPress güvenli modda çalışamadığı için yayını kesti. Şimdi derin bir nefes al, kahvenden bir yudum çek ve bu gizemli beyaz duvarı yıkmak için kullanacağımız siber balyozları sırasıyla indirmeye başlayalım.

1. Adım: WordPress’in Ağzını Arayın (WP_DEBUG Modunu Aktif Etmek)

Sana hiçbir şey söylemeyen bir düşmanı yenemezsin şef. İlk yapmamız gereken şey, WordPress’e “Bana neden sustuğunu ve hangi satırda patladığını hemen söyle!” emrini vermektir. Bunun yolu WordPress’in dahili hata ayıklama sistemini açmaktan geçer.

FTP (FileZilla) veya hosting panelinin (cPanel/Plesk) Dosya Yöneticisi üzerinden sitenin kök dizinine (public_html) sız. wp-config.php dosyasını bul ve bir editörle aç. Şu satırı ara:

define( 'WP_DEBUG', false );

Bu satırı bulduğunda false değerini true olarak değiştir. Eğer böyle bir satır yoksa, dosyanın en altındaki kapatma satırının hemen üzerine kendin ekle. Tam korumalı bir debug işlemi için şu 3 satırı alt alta yapıştırman en temizidir:

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

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

Dosyayı kaydet ve sitenin ana sayfasını yenile. Bembeyaz ekranın yerini artık teknik terimlerin, dosya yollarının uçuştuğu karmaşık ama altın değerinde bir hata mesajı alacaktır. Ekranda büyük ihtimalle Fatal error: Uncaught Error... in /public_html/wp-content/plugins/suclu-eklenti/... şeklinde bir ibare göreceksin. Tebrikler, suçluyu nokta atışı tespit ettin! Artık doğrudan o eklentiye müdahale edebilirsin.

2. Adım: Eklentileri (Plugins) Güvenli Modda Susturmak

Eğer debug modunu açmana rağmen ekrana bir yazı gelmediyse ya da hata mesajı doğrudan bir eklenti klasörünü (wp-content/plugins/) işaret ediyorsa, yapacağımız hamle belli. Admin paneline erişemediğimiz için eklentileri FTP üzerinden arkadan dolaşarak kapatacağız.

1. FTP ile sunucuna bağlan ve wp-content klasörüne gir.
2. Burada bulunan plugins klasörünün adını sağ tıklayıp plugins_iptal olarak değiştir.
3. Tarayıcını aç ve sitene girip sayfayı yenile.

Eğer beyaz ekran hatası kaybolduysa ve siten (belki biraz yamuk da olsa) açıldıysa veya admin paneline girebildiysen biliyoruz ki sorun kesinlikle bir eklentide. Şimdi klasörün adını tekrar plugins yap ve içine gir. Eklenti klasörlerinin adını tek tek değiştirerek (Örn: wordfence klasörünü wordfence_iptal yapmak gibi) sitenin hangi eklentide patladığını bulana kadar bu eliminasyon sürecini devam ettir. Suçluyu bulduğunda o eklentiyi sil veya güncelle şef!

3. Adım: Temayı Devre Dışı Bırakıp Fabrika Ayarlarına Zorlamak

Eklentileri kapattın ama site hala bembeyaz mı? O zaman hedef tahtasına sitenin tasarım giysisini, yani temanı koyuyoruz. Özellikle tema güncellemelerinde veya functions.php dosyasına elinle eklediğin hatalı bir kod bloğunda virgül unuttuysan site anında felç olur.

Mantık tıpkı eklentilerdeki gibi işler:

• wp-content/themes/ dizinine git.
• Şu an aktif olarak kullandığın temanın klasör adını (Örn: my-super-theme ise my-super-theme_iptal) değiştir.
• WordPress aktif temayı bulamadığında çuval döküp çökmek yerine otomatik olarak sistemde yüklü olan varsayılan WordPress temalarından birini (Twenty Twenty-Four gibi) aktif etmeye çalışır.

Siten varsayılan temayla açılıyorsa, sorun eski temanın kodlarındadır. Yedeklerini kontrol et, functions.php dosyana en son ne yazıp bozduğunu hatırla ve kodları temizle.

4. Adım: PHP Bellek Limitini (Memory Limit) Göklere Çıkarın

Bazen sitende hiçbir kod hatası yoktur şef. Sadece siten o kadar büyümüştür, o kadar ağır eklentiler (Elementor, WooCommerce vb.) aynı anda çalışıyordur ki, sunucunun WordPress’e ayırdığı varsayılan RAM miktarı bu yükü kaldırmaya yetmez. Kod çalışmaya başlar, RAM dolar, sunucu nefessiz kalır ve işlem yarıda kesildiği için ekrana beyaz ekran basılır.

Bunu aşmak için WordPress’e daha fazla kaynak tüketme yetkisi vermeliyiz. Yine o meşhur wp-config.php dosyamızı açıyoruz ve içine şu can suyu kodunu zerk ediyoruz:

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

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

Bu kod WordPress’in bellek limitini 512 MB’a yükseltir. Eğer paylaşımlı bir hosting kullanıyorsan ve firmanın sunucu tarafında koyduğu katı bir limit yoksa, bu hamle sitenin tıkanan damarlarını açacak ve beyaz ekran sorununu anında tarihe gömecektir.

5. Adım: PHP Sürümü Uyuşmazlıklarını Ayıklayın

2026 yılındayız ve modern web sunucuları artık PHP 8.3 ve üzerini standart olarak kullanıyor. Ancak senin sitende 4 yıldır güncellenmeyen, eski ama vazgeçemediğin bir eklenti varsa, bu eklenti yeni PHP sürümlerindeki modern fonksiyonları anlayamaz ve “Fatal Error” vererek siteni beyaz ekrana gömer. Ya da tam tersi; teman modern PHP 8.3 mimarisine göre yazılmıştır ama hosting panelinde hala PHP 7.4 aktif kalmıştır.

• Çözüm: Hosting yönetim paneline (cPanel/Plesk) gir. “PHP Sürümü Seçimi” (Select PHP Version) menüsünü bul. Sitenin sürümünü kademeli olarak (Örn: 8.3’ten 8.2’ye veya 8.1’e) düşürerek ya da eskiyse yükselterek siteni test et. Doğru kombinasyonu bulduğunda site aslanlar gibi geri gelecektir.

💡 Teknik İpucu (Expert Box)

Bunu biliyor muydunuz? Bazen beyaz ekran hatası o kadar sinsi bir sebepten kaynaklanır ki kodlarda günlerce hata ararsınız ama bulamazsınız. Suçlu, temanızın functions.php veya bir eklenti dosyasının en altındaki basit bir boşluk karakteridir. PHP dosyalarında kodlar <?php ile başlar ve eğer dosya sadece saf PHP kodundan oluşuyorsa sonuna ?> kapatma etiketi koyulması zorunlu değildir, hatta koyulmaması önerilir. Eğer bir kodun sonuna ?> koyup, arkasından eliniz kazara çarptıysa ve bir satır boşluk (Space/Enter) bıraktıysanız, PHP o boşluğu dışarıya bir HTML çıktısı olarak göndermeye çalışır. Bu durum WordPress header (başlık) yönlendirmelerini bozarak sitenin tamamen bembeyaz kalmasına neden olur! PHP dosyalarınızın sonunda gereksiz boşluk bırakmayın şef!

Sonuç: Beyaz Duvarı Yıktın, Siten Tekrar Ayakta!

Gördüğün gibi şef, WordPress’in o korkunç “Beyaz Ekran Hatası” aslında panik yapılacak bir siber çöküş değil; sadece sunucunun arkada bir yerde bir koda takılıp düşmesidir. Sırasıyla debug modunu açıp, eklenti ve temaları eleyerek, bellek limitlerini güncellediğinde bu hatayı dize getirmemek imkansızdır. Webmasterlığın altın kuralı: Panik yapma, logları oku, hata kodunu takip et!

Senin beyaz ekran kabusunu bu adımlardan hangisi çözdü? Yoksa hala ekrana boş boş bakmaya devam mı ediyorsun? Yorumlara debug modunda aldığın o hata kodunu yapıştır, sunucu loglarını ve PHP hatalarını birlikte ayıklayıp siteni hemen ayağa kaldıralım!