İçindekiler
Bu yazıda neler bulacaksınız?WordPress beyaz ekran hatası, web sitesinin yüklenmeye çalışırken boş bir sayfa göstermesi veya kritik bir hata nedeniyle içeriği görüntüleyememesi durumudur. Sorun bazen yalnızca ana sayfada, bazen yönetim panelinde, bazen de sitenin tamamında ortaya çıkar. Özellikle tema veya eklenti güncellemesinden sonra görülen bu problem, çoğunlukla PHP hataları, uyumsuz yazılımlar ya da yetersiz sunucu kaynaklarıyla ilişkilidir.
Bu hatayı çözmek için WordPress’i hemen yeniden kurmanız veya bütün dosyaları silmeniz gerekmez. Öncelikle hatanın hangi bileşenden kaynaklandığını belirlemek, ardından yalnızca sorunlu bölüme müdahale etmek gerekir. Böylece mevcut içeriklerinizi ve site ayarlarınızı koruyarak web sitenizi yeniden çalışır hâle getirebilirsiniz.
WordPress Beyaz Ekran Hatası Nedir?
WordPress beyaz ekran hatası, İngilizcede White Screen of Death veya kısaca WSOD olarak adlandırılır. WordPress sayfayı oluştururken karşılaştığı bir hata nedeniyle işlemi tamamlayamadığında tarayıcıda boş bir ekran görüntülenebilir.
Bazı durumlarda tamamen beyaz bir sayfa yerine şu mesajla karşılaşabilirsiniz:
There has been a critical error on this website.
Bu mesaj, WordPress’in çalışmasını engelleyen kritik bir hata algıladığını gösterir. WordPress’in güncel sürümlerinde bazı kritik PHP hataları için Kurtarma Modu da devreye girebilir.
Beyaz ekranın görünmesi, web sitesindeki bütün içeriklerin kaybolduğu anlamına gelmez. Yazılarınız, sayfalarınız ve medya dosyalarınız sunucuda duruyor olabilir. Sorun çoğu zaman WordPress’in bu içerikleri görüntülemek için kullandığı tema, eklenti veya PHP koduyla ilgilidir.
WordPress Beyaz Ekran Hatası Neden Oluşur?
Bir WordPress sitesinde beyaz ekran hatasının tek bir nedeni yoktur. Sorunun ne zaman başladığı, hangi sayfaları etkilediği ve öncesinde yapılan değişiklikler doğru teşhis açısından önemlidir.
1. Eklenti çakışmaları
WordPress sitelerinde beyaz ekranın en sık karşılaşılan nedenlerinden biri eklentiler arasındaki uyumsuzluklardır. İki eklenti aynı işlevi farklı yöntemlerle yönetmeye çalışabilir veya bir eklentinin kullandığı PHP fonksiyonu diğer bileşenlerle uyumsuz olabilir.
Örneğin sitenize yeni bir önbellekleme eklentisi kurduğunuzu ve hemen ardından yönetim panelinin açılmadığını düşünelim. Yeni eklenti, mevcut tema veya başka bir eklentiyle çakışıyor olabilir.
Yanlış yaklaşım: Sorunu çözmek için bütün eklentileri kalıcı olarak silmek.
Doğru yaklaşım: Önce hata kayıtlarını incelemek, ardından eklentileri kontrollü biçimde devre dışı bırakarak sorunlu bileşeni tespit etmek.
2. Tema kaynaklı PHP hataları
Aktif WordPress teması, sayfaların nasıl görüntüleneceğini belirleyen dosyaları içerir. Tema dosyalarındaki hatalı PHP kodu, eksik fonksiyonlar veya kullanılan WordPress sürümüyle uyumsuz kodlar beyaz ekran oluşmasına neden olabilir.
Özellikle tema güncellemesi, özel kod ekleme veya functions.php dosyasını düzenleme sonrasında sorun başladıysa ilk incelenmesi gereken alanlardan biri aktif temadır.
Sayfa oluşturucu kullanan sitelerde tema ile oluşturucu arasındaki uyumluluk da değerlendirilmelidir. Örneğin tema dosyasına eklenen hatalı bir kod, yalnızca belirli sayfa şablonlarını değil bütün siteyi etkileyebilir.
3. PHP sürümü uyumsuzluğu
WordPress, temalar ve eklentiler belirli PHP sürümleriyle uyumlu olacak şekilde geliştirilir. Sunucudaki PHP sürümü değiştirildiğinde eski bir eklenti veya tema artık desteklenmeyen bir fonksiyon kullanabilir.
Bu durum özellikle hosting sağlayıcısının PHP sürümünü yükseltmesinden sonra ortaya çıkabilir. Site daha önce sorunsuz çalışırken güncelleme sonrasında beyaz ekran veya kritik hata mesajı verebilir.
Çözüm için kullanılan WordPress sürümünün, temanın ve eklentilerin desteklediği PHP sürümünü kontrol edin. PHP sürümünü rastgele düşürmek yerine hata kayıtlarında görülen uyumsuzluğu gidermeye çalışın.
4. PHP bellek sınırının aşılması
WordPress, sayfaları oluştururken PHP belleğini kullanır. Çok sayıda eklenti, büyük veri işlemleri veya ağır sayfa oluşturma işlemleri mevcut bellek sınırını aşarsa işlem tamamlanamayabilir.
Bu durumda hata kayıtlarında Allowed memory size exhausted benzeri bir mesaj görülebilir.
Özellikle büyük görsel galerileri, kapsamlı sayfa oluşturucular, e-ticaret eklentileri ve yoğun işlem yapan yönetim araçları bellek kullanımını artırabilir. Sorun yalnızca bellek sınırını yükselterek değil, gereksiz kaynak tüketiminin nedenini belirleyerek çözülmelidir.
5. Başarısız WordPress veya eklenti güncellemesi
WordPress çekirdeği, tema veya eklenti güncellemesi sırasında bağlantı kesilmesi, dosyaların eksik yüklenmesi ya da dosya izinlerinin yanlış olması bazı bileşenlerin düzgün çalışmasını engelleyebilir.
Örneğin bir eklenti güncellemesi sırasında sunucu bağlantısı kesilirse eski ve yeni sürüme ait dosyalar karışabilir. Bu durumda WordPress ilgili eklentiyi yüklerken hata verebilir.
Güncellemeden hemen sonra başlayan beyaz ekran hatalarında son değişiklikleri incelemek ve güncelleme kayıtlarını kontrol etmek önemlidir.
6. Özel kod hataları
WordPress sitelerinde functions.php dosyasına, özel eklentilere veya kod ekleme araçlarına PHP kodları eklenebilir. Bu kodlarda eksik parantez, yanlış fonksiyon adı veya hatalı değişken kullanımı gibi problemler sitenin çalışmasını engelleyebilir.
Özellikle hazır kodları doğrudan canlı siteye eklemek risklidir. Kodun kullanılan PHP sürümüyle uyumlu olması ve mevcut tema yapısını bozmaması gerekir.
7. Sunucu veya dosya sorunları
Her beyaz ekran hatası WordPress kaynaklı değildir. Sunucu kaynaklarının tükenmesi, bozuk dosyalar, disk alanının dolması veya hosting altyapısındaki geçici kesintiler de sayfaların görüntülenmesini engelleyebilir.
Birden fazla web sitesinde aynı anda sorun yaşanıyorsa veya WordPress hata kayıtlarında belirgin bir neden bulunamıyorsa hosting sağlayıcısından sunucu günlüklerini ve servis durumunu kontrol etmesini isteyin.
WordPress Beyaz Ekran Hatası Nasıl Çözülür?
Çözüm sürecine başlamadan önce sitenin dosyalarını ve veritabanını yedekleyin. Yönetim paneline erişemiyorsanız hosting panelindeki Dosya Yöneticisi veya FTP/SFTP üzerinden işlem yapabilirsiniz.
1. WordPress Kurtarma Modunu kontrol edin
WordPress 5.2 ve sonraki sürümlerde bazı kritik hatalar algılandığında Kurtarma Modu devreye girebilir. Bu özellik, sorunlu eklenti veya temanın yönetici oturumunda geçici olarak duraklatılmasına yardımcı olur.
Öncelikle WordPress yönetici e-posta adresinizi kontrol edin. Kritik hata algılandığında WordPress, sorunun kaynağı ve özel giriş bağlantısı hakkında bir bildirim gönderebilir.
Yapmanız gerekenler şunlardır:
- WordPress yönetici e-posta hesabınızı kontrol edin.
- Gelen kutusunda ve spam klasöründe kritik hata bildirimini arayın.
- Bildirimdeki Kurtarma Modu bağlantısını açın.
- Yönetim paneline giriş yaptıktan sonra hata bildirimini inceleyin.
- Soruna neden olan eklenti veya temayı geçici olarak devre dışı bırakın.
- Gerekli düzeltmeyi yaptıktan sonra Kurtarma Modundan çıkıp siteyi test edin.
Kurtarma Modu her hatada devreye girmez. Özellikle arka plan görevlerinde veya farklı işlem türlerinde oluşan hatalar için bildirim gelmeyebilir. E-posta ulaşmadıysa diğer teşhis yöntemlerine geçebilirsiniz.
2. WordPress hata kayıtlarını etkinleştirin
Hatanın kaynağını tahmin etmek yerine hata kayıtlarını incelemek daha doğru bir yöntemdir. WordPress’in hata ayıklama özellikleri, PHP hatalarının kaydedilmesine yardımcı olur.
Hosting panelinden wp-config.php dosyasını açın. Dosyada daha önce tanımlanmış WP_DEBUG ayarını bulun. Mevcut bir tanım varsa ikinci kez eklemek yerine mevcut ayarı düzenleyin.
Hata kayıtlarını etkinleştirmek için şu yapılandırma kullanılabilir:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Bu ayarlar, WordPress hata ayıklama kayıtlarının wp-content/debug.log dosyasına yazılmasını sağlar ve hataların ziyaretçilere doğrudan gösterilmesini engeller.
Değişiklikten sonra hata veren sayfayı yeniden açın. Ardından Dosya Yöneticisi üzerinden wp-content klasöründeki debug.log dosyasını inceleyin.
Örneğin kayıtlarda aşağıdaki gibi bir ifade bulunabilir:
PHP Fatal error: Uncaught Error in
/home/site/public_html/wp-content/plugins/example/plugin.php
Bu örnekte hata yolu bir eklenti klasörünü gösterdiğinden ilgili eklentinin incelenmesi gerekir. Hata mesajında dosya yolu ve satır numarası bulunuyorsa sorunun kaynağını belirlemek kolaylaşır.
Güvenlik uyarısı: Hata ayıklama kayıtları sunucu yolları ve teknik bilgiler içerebilir. İşlem tamamlandığında WP_DEBUG ayarını tekrar kapatın ve erişilebilir durumdaki hata kayıtlarını güvenli şekilde yönetin.
3. Bütün eklentileri geçici olarak devre dışı bırakın
Yönetim paneline erişemiyorsanız eklentileri hosting paneli üzerinden devre dışı bırakabilirsiniz.
- Hosting panelinizde Dosya Yöneticisini açın.
- WordPress kurulumunun bulunduğu dizine girin.
- wp-content klasörünü açın.
- plugins klasörünün adını geçici olarak plugins-disabled şeklinde değiştirin.
- Web sitenizi ve yönetim panelini yeniden açmayı deneyin.
Site bu işlemden sonra açılıyorsa sorun eklentilerden biriyle ilişkili olabilir. Ancak bu işlem bütün eklentileri devre dışı bırakır ve sitenin bazı özelliklerinin geçici olarak çalışmamasına neden olur.
Sorunlu eklentiyi belirlemek için klasörün adını tekrar plugins olarak düzenleyin. Ardından WordPress yönetim panelinden eklentileri kontrollü şekilde etkinleştirin. Her etkinleştirme sonrasında siteyi kontrol ederek hataya neden olan eklentiyi belirleyin.
Çok sayıda eklentinin bulunduğu sitelerde hata kayıtları hangi eklentinin sorun çıkardığını daha hızlı gösterebilir. Bu nedenle bütün eklentileri devre dışı bırakmak her zaman ilk tercih olmak zorunda değildir.
4. Temayı geçici olarak değiştirin
Eklentiler devre dışı bırakıldığı hâlde beyaz ekran devam ediyorsa aktif temayı kontrol edin. Özellikle tema güncellemesinden veya functions.php dosyasına kod eklenmesinden sonra sorun başladıysa bu adım önemlidir.
Yönetim paneline erişebiliyorsanız Görünüm ve Temalar bölümünden varsayılan bir WordPress temasını etkinleştirerek test yapabilirsiniz.
Yönetim paneli açılmıyorsa şu yöntemi uygulayabilirsiniz:
- Hosting Dosya Yöneticisini açın.
- wp-content/themes klasörüne girin.
- Aktif temanın klasör adını geçici olarak değiştirin.
- Kurulumda uyumlu bir varsayılan WordPress teması bulunduğundan emin olun.
- Siteyi yeniden açarak sonucu kontrol edin.
WordPress uygun bir varsayılan tema bulabilirse bu temaya geçebilir. Ancak sunucuda başka bir kullanılabilir tema yoksa bu yöntem beklenen sonucu vermeyebilir.
Site açıldığında sorun büyük olasılıkla aktif tema veya temaya eklenen özel kodlarla ilişkilidir. Temayı yeniden kullanmadan önce hatalı kodu düzeltmeli veya uyumlu sürümü yüklemelisiniz.
5. PHP bellek sınırını kontrol edin
Hata kayıtlarında bellek sınırının aşıldığı görülüyorsa hosting panelinizdeki PHP ayarlarını kontrol edin. Kullanılan PHP sürümüne ve hosting paketine göre bellek sınırı farklı olabilir.
WordPress yapılandırmasında aşağıdaki tanım kullanılabilir:
define('WP_MEMORY_LIMIT', '256M');
Bu ayar WordPress için talep edilen bellek sınırını belirtir. Ancak hosting sağlayıcınızın belirlediği üst sınırı aşamaz. Ayrıca mevcut WP_MEMORY_LIMIT tanımı varsa yeni bir satır eklemek yerine mevcut değeri düzenlemelisiniz.
Bellek sınırını yükseltmek sorunu geçici olarak hafifletebilir. Ancak bellek tüketimi gereksiz bir eklenti veya hatalı kod nedeniyle artıyorsa asıl nedenin de giderilmesi gerekir.
6. PHP sürümünü ve uyumluluğu inceleyin
Hosting panelinizde PHP sürümünün hangi değerde çalıştığını kontrol edin. Ardından WordPress çekirdeğinin, aktif temanın ve eklentilerin bu sürümü destekleyip desteklemediğini değerlendirin.
Özellikle PHP sürümü değiştirildikten sonra beyaz ekran başladıysa son değişikliği dikkate alın. Gerekirse hosting sağlayıcınızdan geçici test ortamı oluşturmasını isteyin.
Canlı sitede PHP sürümünü rastgele değiştirerek deneme yapmak yerine hata kayıtlarında görülen uyumsuzluğu belirlemek daha güvenlidir. Eski bir sürüme dönmek kalıcı çözüm olarak düşünülmemelidir.
7. Önbelleği temizleyin
Bazen sorun giderilmiş olsa bile tarayıcı veya önbellek katmanları nedeniyle eski hata görüntülenmeye devam edebilir. Bu nedenle sorunlu bileşeni düzelttikten sonra tarayıcı önbelleğini ve varsa WordPress önbelleğini temizleyin.
Yönetim paneline erişemiyorsanız önbellek eklentisinin dosya ve yapılandırma yapısını inceleyerek güvenli temizleme yöntemi belirleyin. Sunucu veya CDN önbelleği kullanılıyorsa bu katmanların da temizlenmesi gerekebilir.
8. WordPress çekirdek dosyalarını kontrol edin
Hata kayıtlarında WordPress’in temel dosyalarına işaret eden sorunlar varsa çekirdek dosyaların eksik veya bozulmuş olma ihtimalini değerlendirin.
Bu durumda mevcut WordPress sürümünün temiz dosyalarıyla wp-admin ve wp-includes klasörleri yeniden yüklenebilir. Ancak wp-content klasörü, wp-config.php dosyası ve kullanıcı içerikleri korunmalıdır.
Bu işlem teknik bilgi gerektirir. Yanlış dosyaların üzerine yazılması veya farklı sürümlere ait dosyaların karıştırılması yeni hatalara neden olabilir. İşlem öncesinde tam yedek alın ve mümkünse test ortamında uygulayın.
Beyaz Ekran Hatası Sadece Ana Sayfada Görülüyorsa Ne Yapılmalı?
WordPress sitenizin yönetim paneli ve bazı alt sayfaları açılıyor ancak ana sayfa boş görünüyorsa sorunun kapsamı daha dar olabilir. Ana sayfaya özel bir şablon, bileşen veya sayfa oluşturucu hatalı çalışıyor olabilir.
Özellikle Elementor gibi sayfa oluşturucuların kullanıldığı sitelerde ana sayfada çalışan özel bileşenler, dinamik içerikler veya üçüncü taraf eklentiler incelenmelidir.
Şu kontrolleri gerçekleştirebilirsiniz:
- Son düzenlenen ana sayfa şablonunu kontrol edin.
- Sayfada kullanılan özel widget ve bileşenleri inceleyin.
- Son eklenen özel CSS ve JavaScript kodlarını değerlendirin.
- Sayfa oluşturucu eklentisinin hata kayıtlarını kontrol edin.
- Varsa alternatif bir şablonla ana sayfayı test edin.
Yalnızca ana sayfayı etkileyen bir sorunda bütün eklentileri silmek veya WordPress’i yeniden kurmak gereksiz müdahale olabilir. Önce ana sayfaya özgü bileşenleri incelemek daha doğru bir yaklaşımdır.
WordPress Beyaz Ekran Hatası Yönetim Panelinde Görülüyorsa
Web sitesinin ziyaretçilere açık bölümü çalışırken wp-admin ekranının boş kalması, sorunun yönetim panelinde çalışan bir bileşenden kaynaklanabileceğini düşündürür.
Bu durumda yönetim paneline özel çalışan eklentiler, kullanıcı yetkileri, PHP hataları ve yönetim ekranlarına eklenen özel kodlar incelenmelidir.
Örneğin güvenlik eklentisi, yönetim paneli özelleştirme aracı veya sayfa oluşturucu eklentisi yalnızca wp-admin ekranında hata oluşturabilir. Hata kayıtlarında wp-admin, eklenti veya tema dosyalarının yolu bulunuyorsa bu bilgiler teşhis için kullanılabilir.
WordPress Beyaz Ekran Hatasını Önlemek İçin Neler Yapılmalı?
Beyaz ekran hatasını önlemek için bütün teknik sorunları ortadan kaldırmak mümkün olmasa da düzenli bakım ve kontrollü güncelleme alışkanlıkları riski azaltabilir.
- Güncelleme öncesinde yedek alın: WordPress, tema veya eklenti güncellemeden önce dosyaları ve veritabanını yedekleyin.
- Gereksiz eklentileri kaldırın: Kullanılmayan ve güncel tutulmayan eklentileri sitenizde bırakmayın.
- Uyumluluğu kontrol edin: Tema ve eklentilerin kullandığınız WordPress ve PHP sürümleriyle uyumlu olmasına dikkat edin.
- Özel kodları test edin: functions.php veya özel eklentilere eklenen kodları önce test ortamında deneyin.
- Hata kayıtlarını takip edin: Tekrarlayan PHP hatalarını büyümeden tespit etmeye çalışın.
- Sunucu kaynaklarını izleyin: Bellek, işlemci ve disk kullanımını düzenli olarak kontrol edin.
- Bakım işlemlerini planlayın: Önemli güncellemeleri yoğun ziyaretçi saatlerinde uygulamamaya çalışın.
Özellikle ticari amaçla kullanılan web sitelerinde test ortamı oluşturmak önemli bir avantaj sağlar. Böylece yeni tema veya eklenti sürümlerini ziyaretçilerin kullandığı canlı siteyi etkilemeden deneyebilirsiniz.
Sık Sorulan Sorular
WordPress beyaz ekran hatası içeriklerimi siler mi?
Hayır. Beyaz ekran hatası tek başına yazılarınızı, sayfalarınızı veya medya dosyalarınızı silmez. Genellikle WordPress’in sayfayı oluşturmasını engelleyen bir yazılım veya sunucu problemi bulunur. Yine de müdahale öncesinde yedek almak gerekir.
WordPress beyaz ekran hatası neden güncellemeden sonra oluşur?
Güncellenen tema veya eklenti mevcut yazılım bileşenleriyle uyumsuz olabilir. Ayrıca güncelleme sırasında dosyaların eksik yüklenmesi veya PHP sürümüyle ilgili bir uyumsuzluk da ortaya çıkabilir. Hata kayıtları hangi bileşenin sorun çıkardığını belirlemeye yardımcı olur.
Beyaz ekran hatasını düzeltmek için WordPress’i yeniden kurmalı mıyım?
Çoğu durumda hayır. Önce eklenti, tema, PHP sürümü ve hata kayıtları incelenmelidir. Sorunlu bileşen düzeltildiğinde mevcut kurulum korunarak site yeniden çalıştırılabilir. Yeniden kurulum ancak çekirdek dosyalarda ciddi bozulma gibi durumlarda ve doğru yedekleme sonrasında değerlendirilmelidir.
WordPress beyaz ekran hatası hosting kaynaklı olabilir mi?
Evet. Yetersiz bellek, disk alanının dolması, sunucu kesintisi veya PHP işlem sınırlarının aşılması beyaz ekran oluşmasına neden olabilir. Bu tür durumlarda hosting sağlayıcısının sunucu kayıtlarını incelemesi gerekebilir.
WP_DEBUG ayarını sürekli açık bırakmalı mıyım?
Canlı bir web sitesinde hata ayıklama ayarlarını sürekli açık bırakmak önerilmez. Sorun giderme sırasında hata kayıtlarını etkinleştirebilir, işlem tamamlandığında ayarları kapatabilirsiniz. Hata mesajlarının ziyaretçilere gösterilmesi güvenlik açısından uygun değildir.
WordPress beyaz ekran hatası, ilk bakışta ciddi bir arıza gibi görünse de çoğu zaman belirli bir eklenti, tema, PHP kodu veya sunucu yapılandırmasıyla ilişkilidir. Sorunu çözmenin en güvenilir yolu, rastgele dosya silmek yerine hata kayıtlarını incelemek ve olası nedenleri sırayla ele almaktır.
Öncelikle WordPress Kurtarma Modunu ve yönetici e-posta bildirimlerini kontrol edin. Ardından hata kayıtlarından yararlanarak sorunlu bileşeni belirleyin. Yönetim paneline erişilemiyorsa eklentileri veya temayı Dosya Yöneticisi üzerinden geçici olarak devre dışı bırakabilirsiniz. Bellek sınırı, PHP uyumluluğu ve sunucu kaynakları da teşhis sürecinin önemli parçalarıdır.
WordPress sitenizin uzun süre kararlı çalışması için güncellemeleri kontrollü yapmak, yedekleri düzenli almak ve teknik hataları erken aşamada tespit etmek gerekir. Böylece beyaz ekran gibi erişim sorunlarında gereksiz müdahalelerden kaçınabilir, sitenizi daha kısa sürede yeniden çalışır hâle getirebilirsiniz.



