WordPress beyaz ekran sorunu, web sitesinin herhangi bir hata mesajı göstermeden tamamen veya kısmen boş beyaz sayfa açması durumudur. WordPress hosting altyapısı üzerinde çalışan PHP işlemlerindeki hatalar, uyumsuz eklentiler, tema sorunları ve yetersiz bellek limiti bu problemin yaygın nedenleri arasındadır.
Beyaz ekran yalnızca web sitesinin belirli bir sayfasında görülebileceği gibi sitenin tamamını veya WordPress yönetim panelini de etkileyebilir. Sorunun kaynağını belirlemek için öncelikle son yapılan değişiklikler kontrol edilmeli, ardından eklenti, tema, PHP ve kaynak kullanımı sırasıyla incelenmelidir.
WordPress Beyaz Ekran Sorunu Nedir?
WordPress beyaz ekran hatası, yaygın olarak “White Screen of Death (WSoD)” olarak adlandırılan ve WordPress’in sayfayı normal şekilde oluşturamadığı durumlarda karşılaşılan bir problemdir. Ekranda hata kodu veya açıklama bulunmadığı için sorunun kaynağını ilk bakışta belirlemek zor olabilir.
Problem bazen yalnızca ziyaretçilerin gördüğü sayfalarda ortaya çıkarken wp-admin yönetim paneli çalışmaya devam edebilir. Bazı durumlarda ise hem web sitesi hem de yönetim paneli beyaz ekran verebilir.
Özellikle web hosting kaynakları yetersiz kaldığında veya PHP işlemi kritik bir hatayla sonlandığında WordPress sayfayı tamamlayamayabilir. Bu nedenle yalnızca tarayıcıyı yenilemek yerine sunucu tarafındaki hata kayıtlarının da kontrol edilmesi gerekir.
WordPress Beyaz Ekran Hatası Neden Olur?
WordPress’te beyaz ekranın tek bir nedeni yoktur. Sorun genellikle eklenti veya tema değişikliği, PHP hatası ya da sunucu kaynaklarının yetersiz kalması sonrasında ortaya çıkar. En yaygın nedenler şunlardır;
- Hatalı veya uyumsuz WordPress eklentileri.
- Tema dosyalarında oluşan PHP hataları.
- PHP memory limitinin yetersiz olması.
- Kullanılan PHP sürümüyle eklenti veya temaların uyumsuz olması.
- Eksik veya bozulmuş WordPress çekirdek dosyaları.
- Başarısız WordPress, tema veya eklenti güncellemeleri.
- Hatalı kod değişiklikleri.
- Önbellek sorunları.
- Sunucu yapılandırmasındaki problemler.
WordPress Beyaz Ekran Sorunu Nasıl Çözülür?
WordPress yönetim paneline erişilebiliyorsa çözüm işlemleri panel üzerinden gerçekleştirilebilir. wp-admin sayfası da beyaz ekran veriyorsa FTP veya hosting kontrol panelindeki dosya yöneticisini kullanmak gerekebilir.
İşlemlere başlamadan önce mevcut WordPress dosyalarının ve veritabanının yedeğinin alınması önerilir.
1. WordPress Eklentilerini Devre Dışı Bırakın
Beyaz ekranın en yaygın nedenlerinden biri hatalı veya uyumsuz eklentilerdir. Sorun yeni bir eklenti kurduktan veya mevcut bir eklentiyi güncelledikten sonra başladıysa öncelikle ilgili eklentiyi devre dışı bırakın.
Hangi eklentinin probleme neden olduğu bilinmiyorsa tüm eklentileri geçici olarak devre dışı bırakabilirsiniz. Site yeniden çalışmaya başlarsa eklentileri tek tek etkinleştirerek sorunlu eklentiyi tespit edebilirsiniz.
WordPress yönetim paneline erişilemiyorsa dosya yöneticisi veya FTP üzerinden:
wp-content/plugins
klasörüne ulaşın ve plugins klasörünün adını geçici olarak örneğin:
plugins-disabled
şeklinde değiştirin.
WordPress eklenti klasörünü bulamadığında eklentileri devre dışı bırakacaktır. Web sitesi açılırsa problemin eklentilerden biriyle ilişkili olduğu düşünülebilir. Test tamamlandıktan sonra klasör adını tekrar plugins olarak değiştirebilirsiniz.
2. Aktif WordPress Temasını Kontrol Edin
Eklentilerin devre dışı bırakılması sorunu çözmedi ise aktif tema kontrol edilmelidir. Tema dosyalarında oluşan PHP hataları veya kullanılan PHP sürümüyle uyumsuzluk beyaz ekrana neden olabilir.
Sorun tema güncellemesinden veya tema dosyalarında yapılan bir değişiklikten sonra başladıysa yapılan son işlemi geri alın.
Yönetim paneline erişilebiliyorsa geçici olarak güncel ve varsayılan bir WordPress temasına geçerek siteyi yeniden kontrol edebilirsiniz. Beyaz ekran ortadan kalkarsa sorun aktif temayla ilişkili olabilir.
Özel olarak düzenlenmiş tema dosyalarını değiştirirken mevcut dosyaların yedeğini almadan işlem yapılmamalıdır.
3. WordPress PHP Memory Limitini Kontrol Edin
WordPress, eklentiler ve temalar PHP işlemleri sırasında belirli miktarda belleğe ihtiyaç duyar. Kullanılabilir bellek sınırı aşıldığında işlem tamamlanamayabilir ve beyaz ekran dahil farklı hatalar ortaya çıkabilir.
Öncelikle mevcut sunucu kaynakları ve PHP hata kayıtları kontrol edilmelidir. Hata kayıtlarında Allowed memory size exhausted benzeri bir ifade bulunuyorsa PHP bellek limitinin yetersiz kaldığı anlaşılabilir.
WordPress bellek limitini yapılandırmak için wp-config.php dosyasına uygun koşullarda aşağıdaki tanım eklenebilir:
define( ‘WP_MEMORY_LIMIT’, ‘256M’ );
Ancak bu değer hosting hesabının PHP bellek sınırını aşamaz. Sunucu tarafındaki limit daha düşükse yalnızca wp-config.php dosyasını değiştirmek yeterli olmayacaktır.
Ayrıca sürekli yükselen RAM kullanımı doğrudan daha fazla kaynak eklemek yerine önce araştırılmalıdır.
4. WordPress Hata Ayıklama Modunu Açın
Beyaz ekranın üzerinde herhangi bir hata mesajı bulunmadığında WordPress debug özelliği sorunun kaynağını belirlemeye yardımcı olabilir.
wp-config.php dosyasında aşağıdaki ayarlar kullanılabilir:
define( ‘WP_DEBUG’, true );
define( ‘WP_DEBUG_LOG’, true );
define( ‘WP_DEBUG_DISPLAY’, false );
Bu yapılandırmada hataların ziyaretçilere doğrudan gösterilmesi yerine log dosyasına kaydedilmesi sağlanabilir. Oluşan hata kayıtları genellikle;
wp-content/debug.log
dosyasında incelenebilir.
Buradaki hata mesajında belirli bir eklenti, tema dosyası veya PHP fonksiyonu görünüyorsa problemin kaynağı daha kolay tespit edilebilir.
Canlı bir web sitesinde ayrıntılı PHP hata mesajlarının ziyaretçilere gösterilmesi güvenlik açısından uygun değildir. Sorun giderildikten sonra debug modu da kapatılmalıdır.
5. PHP Sürümünü Kontrol Edin
PHP sürümünün değiştirilmesinden sonra beyaz ekran başladıysa WordPress, tema ve eklentilerin kullanılan PHP sürümüyle uyumlu olup olmadığını kontrol edin.
Özellikle uzun süredir güncellenmeyen eklenti veya temalar yeni PHP sürümleriyle çalışırken kritik hatalara neden olabilir. Benzer şekilde eski PHP sürümleri de güncel WordPress bileşenleriyle uyumluluk sorunları oluşturabilir.
PHP sürümünü rastgele değiştirmek yerine hata kayıtlarının incelenmesi ve kullanılan WordPress bileşenlerinin sistem gereksinimlerinin kontrol edilmesi daha doğru bir yöntemdir.
6. WordPress Çekirdek Dosyalarını Kontrol Edin
Eksik veya bozulmuş WordPress çekirdek dosyaları da sitenin düzgün çalışmasını engelleyebilir. Sorun başarısız bir WordPress güncellemesinden sonra başladıysa çekirdek dosyaların zarar görüp görmediği kontrol edilmelidir.
WordPress yönetim paneline erişilebiliyorsa güncel WordPress sürümünün çekirdek dosyaları yeniden yüklenebilir. Manuel işlem yapılacaksa wp-content klasörü ve wp-config.php gibi siteye özel verilerin üzerine yazılmamasına özellikle dikkat edilmelidir.
Bu işlem öncesinde dosya ve veritabanı yedeği alınması önemlidir.
7. WordPress Önbelleğini Temizleyin
Sorun giderilmiş olmasına rağmen beyaz ekran görüntülenmeye devam ediyorsa eski sayfanın önbellekten sunulması ihtimali kontrol edilmelidir. Kullanılan yapıya göre;
- WordPress cache eklentisini,
- Hosting tarafındaki sunucu önbelleğini,
- CDN önbelleğini,
- Tarayıcı önbelleğini
temizleyerek sayfayı tekrar kontrol edin. Önbelleği temizlemek temel PHP veya uygulama hatasını çözmez. Bu işlem daha çok sorun giderildikten sonra eski hatalı çıktının görüntülenmeye devam etmesini önlemek amacıyla kullanılmalıdır.
WordPress Yönetim Paneli de Beyaz Ekran Veriyorsa Ne Yapılmalı?
WordPress yönetim paneline erişilemiyorsa işlemlerin büyük bölümü FTP veya hosting kontrol panelindeki dosya yöneticisi üzerinden yapılabilir.
İlk olarak wp-content/plugins klasörünün adını değiştirerek bütün eklentileri geçici olarak devre dışı bırakın. Site açılmazsa aktif temayı kontrol edin ve ardından wp-config.php üzerinden debug log özelliğini etkinleştirerek oluşan hataları inceleyin. Kısaca şu sırayı takip edebilirsiniz;
- Tüm eklentileri devre dışı bırakın.
- Aktif temayı kontrol edin.
- debug.log dosyasını inceleyin.
- PHP memory limitini kontrol edin.
- PHP sürümünü kontrol edin.
- WordPress çekirdek dosyalarını inceleyin.
Her değişiklikten sonra siteyi tekrar test etmek hangi işlemin problemi çözdüğünü belirlemeyi kolaylaştırır.
WordPress Beyaz Ekran Sorunu Devam Ediyorsa Ne Yapılmalı?
Tüm temel kontroller yapılmasına rağmen beyaz ekran devam ediyorsa WordPress debug kayıtlarının yanı sıra PHP error log ve web sunucusu hata kayıtları incelenmelidir. Loglarda hatanın meydana geldiği saate karşılık gelen kayıtlar sorunun kaynağını gösterebilir.
Sunucu yönetimine erişiminiz bulunmuyorsa hosting sağlayıcınızdan hata kayıtlarının ve kaynak kullanımının kontrol edilmesini isteyebilirsiniz. Özellikle CPU veya RAM limitlerine sürekli ulaşılıyorsa önce yüksek kaynak tüketiminin nedeni belirlenmelidir.
Web sitesi optimize edilmesine rağmen mevcut altyapının kaynakları düzenli olarak yetersiz kalıyorsa daha yüksek kaynaklı VPS çözümü değerlendirilebilir. Ancak beyaz ekranın nedeni hatalı bir eklenti veya PHP koduysa sunucu paketini yükseltmek problemi ortadan kaldırmayacaktır.
Sıkça Sorulan Sorular
WordPress neden beyaz ekran verir?
WordPress beyaz ekran sorunu genellikle eklenti veya tema çakışmaları, PHP hataları, yetersiz bellek limiti ya da başarısız güncellemeler nedeniyle ortaya çıkar. Sorunun kaynağını belirlemek için eklentiler, aktif tema, PHP sürümü ve hata kayıtları sırasıyla kontrol edilmelidir.
WordPress beyaz ekran sorunu siteyi siler mi?
Hayır, beyaz ekran görülmesi tek başına web sitesinin veya içeriklerin silindiği anlamına gelmez. Çoğu durumda WordPress çalışmayı engelleyen bir hata nedeniyle sayfayı görüntüleyemez ve sorun giderildiğinde site yeniden erişilebilir hale gelir.
WordPress admin paneli neden beyaz ekran oluyor?
WordPress yönetim panelinin beyaz ekran vermesi hatalı bir eklenti, tema fonksiyonu, PHP uyumsuzluğu veya bellek yetersizliğinden kaynaklanabilir. wp-admin alanına erişilemiyorsa eklentiler FTP veya dosya yöneticisi üzerinden geçici olarak devre dışı bırakılarak sorun araştırılabilir.
WordPress beyaz ekran sorunu eklentilerden kaynaklanabilir mi?
Evet. Uyumsuz, hatalı veya güncelleme sonrasında sorun oluşturan bir eklenti WordPress’te beyaz ekran problemine neden olabilir. Tüm eklentileri geçici olarak devre dışı bırakıp ardından tek tek etkinleştirmek sorunlu eklentinin belirlenmesine yardımcı olur.
WordPress PHP memory limit nasıl artırılır?
PHP bellek limiti hosting kontrol panelinden veya sunucu yapılandırmasına bağlı olarak uygun PHP ayarları üzerinden artırılabilir. Ancak bellek limitini sürekli yükseltmek yerine hangi eklenti, tema veya işlemin aşırı kaynak tükettiğinin de kontrol edilmesi gerekir.
