WordPress yöneticilerinin yaşadığı en sinir bozucu durumlardan biri, siteyi açtığınızda karşınıza hiçbir hata mesajı olmadan bembeyaz bir sayfanın gelmesidir. İngilizce literatürde "White Screen of Death" (WSOD), yani Ölümün Beyaz Ekranı olarak anılan bu sorun, hiçbir ipucu vermediği için panik yaratır. İyi haber şu: neredeyse her vakada arkasında belirli ve çözülebilir bir teknik neden vardır. Bu rehberde, wordpress beyaz ekran çözümü için en sık karşılaşılan senaryoları ve bunları sırayla nasıl elimine edeceğinizi anlatıyoruz.
Beyaz Ekran Neden Oluşur?
Beyaz ekran, PHP'nin bir hata yüzünden çalışmayı durdurması ve bu hatayı ekrana yazdırmaması durumunda ortaya çıkar. Üretim (canlı) sunucularda hata gösterimi güvenlik nedeniyle kapalı olduğundan, kullanıcı yalnızca boş bir sayfa görür. En yaygın tetikleyiciler şunlardır:
- Eklenti veya tema çakışması — bir güncelleme sonrası uyumsuzluk
- PHP bellek limitinin (memory_limit) dolması — özellikle ağır temalarda
- Bozuk veya eksik dosya — yarım kalan bir güncelleme/yükleme
- PHP sürüm uyumsuzluğu — eski bir eklenti yeni PHP'de çalışmaz
.htaccessveyawp-config.phphatası- Sunucu kaynak limitlerinin aşılması
Sorunun nerede olduğunu anlamak için önemli bir ayrım vardır: beyaz ekran tüm sitede mi yoksa sadece yönetici panelinde mi (wp-admin) görünüyor? Sadece ön yüz beyazsa sorun büyük olasılıkla tema ya da ön yüzde çalışan bir eklentidedir. Sadece panel beyazsa neden farklı olabilir. Bu gözlem, aşağıdaki adımları daraltmanıza yardımcı olur.
Adım 1: Hata Ayıklama Modunu Açın
Boş ekranla uğraşmak yerine, WordPress'in size ne olduğunu söylemesini sağlayın. wp-config.php dosyasını DirectAdmin veya Plesk panelinizdeki Dosya Yöneticisi ya da FTP ile açın ve /* That's all, stop editing! */ satırından önce şu satırları ekleyin:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Bu ayarla hatalar ekrana basılmaz (ziyaretçiler görmez), bunun yerine /wp-content/debug.log dosyasına kaydedilir. Sayfayı yeniden yükleyip bu dosyayı açtığınızda genellikle hatanın hangi dosyada ve satırda olduğunu net olarak görürsünüz. Örneğin:
PHP Fatal error: Uncaught Error: Call to undefined function ...
in /wp-content/plugins/eski-eklenti/eklenti.php on line 220
Bu tek satır bile çözümün yarısıdır; çünkü suçlu eklentinin/temanın adını size doğrudan verir. Sorunu çözdükten sonra bu üç satırı silmeyi veya WP_DEBUG'ı false yapmayı unutmayın.
Adım 2: Tüm Eklentileri Devre Dışı Bırakın
Beyaz ekran vakalarının çok büyük bölümü eklenti kaynaklıdır. Panele giremiyorsanız eklentileri panel olmadan da kapatabilirsiniz:
- DirectAdmin/Plesk Dosya Yöneticisi veya FTP ile sitenize bağlanın.
/wp-content/plugins/klasörüne gidin.pluginsklasörünün adını geçici olarakplugins-eskiyapın.
Bu işlem tüm eklentileri tek hamlede devre dışı bırakır. Site açılıyorsa, suçlu bir eklentidir. Şimdi klasör adını tekrar plugins yapın ve içindeki eklentileri tek tek yeniden adlandırarak hangisinin sorunu tetiklediğini bulun. Sorunlu eklentiyi tespit ettiğinizde silebilir, güncelleyebilir veya geliştiricisine bildirebilirsiniz.
Adım 3: Varsayılan Temaya Geçin
Eklentiler suçlu değilse sıra temadadır. Özellikle bir tema güncellemesinden sonra beyaz ekran geldiyse bu olasılık güçlüdür. Temayı şöyle test edin:
/wp-content/themes/klasörüne gidin.- Aktif temanızın klasörünü yeniden adlandırın (örneğin
tema-eski).
WordPress aktif temayı bulamayınca otomatik olarak yüklü bir varsayılan temaya (Twenty Twenty-Four gibi) döner. Site açılırsa sorun temanızdadır. Tema dosyalarında elle düzenleme yaptıysanız (örneğin functions.php'ye kod eklediyseniz), büyük ihtimalle oradaki bir sözdizimi hatası ekranı kilitlemiştir. Bu durumda alt tema (child theme) kullanmak, ileride güncellemelerin değişikliklerinizi silmesini de önler.
Adım 4: PHP Bellek Limitini Artırın
Site "bellek tükendi" (Allowed memory size exhausted) hatası veriyorsa veya beyaz ekran ağır bir sayfada çıkıyorsa, PHP bellek limitini artırmanız gerekir. wp-config.php dosyasına şu satırı ekleyin:
define( 'WP_MEMORY_LIMIT', '256M' );
Bazı sunucularda bu yeterli olmaz; o zaman php.ini veya .htaccess üzerinden tanımlamanız gerekebilir. DirectAdmin ve Plesk panellerinin "PHP Ayarları" / "PHP Seçenekleri" bölümünden memory_limit değerini doğrudan artırabilirsiniz. Aşağıdaki tablo, içerik tipine göre makul başlangıç değerlerini gösterir:
| Site Tipi | Önerilen memory_limit |
|---|---|
| Basit blog / kurumsal site | 128M |
| Eklenti yoğun WordPress | 256M |
| WooCommerce / e-ticaret | 256M – 512M |
| Büyük katalog + sayfa oluşturucu | 512M |
Eğer limiti artırdığınız halde sorun tekrarlıyorsa, bu çoğu zaman bir eklentinin anormal kaynak tükettiğine işarettir; o eklentinin bellek sızıntısı yapmadığından emin olun.
Adım 5: PHP Sürümünü ve Dosya İzinlerini Kontrol Edin
Eski bir eklenti veya tema, yeni bir PHP sürümüyle (örneğin PHP 8.x) uyumsuz olabilir ve ölümcül hata fırlatabilir. Hosting panelinizdeki PHP Sürüm Yöneticisi'nden sitenizin hangi sürümde çalıştığını görün. Geçici bir teşhis için bir alt sürüme (örneğin 8.1) geçip sorunun kaybolup kaybolmadığını test edebilirsiniz. Kalıcı çözüm, eski yazılımı güncellemek ya da değiştirmektir — eski PHP sürümlerinde kalmak güvenlik açığı anlamına gelir.
Bunun yanında dosya ve klasör izinleri de beyaz ekrana yol açabilir. Standart WordPress izinleri:
- Klasörler için 755
- Dosyalar için 644
wp-config.phpiçin 600 veya 640 (daha güvenli)
İzinler yanlışsa PHP dosyaları okuyamaz ve çalışma durur. Panelinizin Dosya Yöneticisi üzerinden izinleri toplu olarak düzeltebilirsiniz.
Adım 6: .htaccess ve Önbelleği Sıfırlayın
Bozuk bir .htaccess dosyası, özellikle yönlendirme veya önbellek kuralları içeriyorsa beyaz ekrana neden olabilir. Mevcut .htaccess dosyasının adını .htaccess-eski yapın ve paneldeki Kalıcı Bağlantılar (Permalinks) sayfasını kaydederek WordPress'in temiz bir kopya oluşturmasını sağlayın (panele girebiliyorsanız).
Ek olarak, bir önbellek eklentisi kullanıyorsanız (WP Rocket, W3 Total Cache gibi) bozuk önbellek dosyaları eski/hatalı çıktıyı sunmaya devam edebilir. /wp-content/cache/ klasörünü temizleyin ve tarayıcı önbelleğinizi de boşaltın.
Hızlı Kontrol Listesi
Acele bir teşhis için sırayla şunları deneyin:
- debug.log'u açıp hatayı okuyun (en hızlı yol).
pluginsklasörünü yeniden adlandırın → eklenti mi?- Temayı varsayılana çevirin → tema mı?
WP_MEMORY_LIMIT'i 256M yapın → bellek mi?- PHP sürümünü ve dosya izinlerini doğrulayın.
.htaccessve önbelleği sıfırlayın.
Bu altı adım, beyaz ekran vakalarının ezici çoğunluğunu çözer. Çözdükten sonra mutlaka güncel bir yedek alın ve eklenti/tema güncellemelerini önce bir test/staging ortamında deneme alışkanlığı edinin; böylece aynı sorunla canlı sitede bir daha karşılaşmazsınız.
Hosting Tarafından Kaynaklanan Durumlar
Yukarıdaki adımların hiçbiri işe yaramıyorsa sorun WordPress'te değil, sunucu tarafında olabilir: PHP işlemcinin çökmesi, kaynak limitlerinin aşılması ya da sunucu hatası (HTTP 500). Bu noktada hosting panelinizdeki hata günlüklerini (error logs) incelemek ya da sağlayıcınızın destek ekibinden yardım almak en doğrusudur. Sağlam altyapı üzerinde çalışan bir hosting, doğru PHP sürümleri ve yeterli bellek limitleriyle bu sorunların çoğunu en baştan engeller.
Hostmana olarak DirectAdmin ve Plesk tabanlı hosting paketlerimizde güncel PHP sürümleri, esnek kaynak ayarları ve kolay erişilebilen hata günlükleri sunuyoruz; daha fazla kontrol isterseniz yurt dışı sanal sunucu seçeneklerimize göz atabilirsiniz. Sitenizin hızını ve durumunu ölçmek için ücretsiz web araçlarımızı kullanabilir, benzer konularda adım adım anlatımlar için bilgi bankamızı inceleyebilirsiniz. Takıldığınız bir nokta olursa uzaktan canlı destek ile ekran paylaşarak yanınızdayız ya da bize ulaşın — beyaz ekranın arkasındaki nedeni birlikte bulalım.