WordPress Beyaz Sayfa Hatası

Sitenize girmek istiyorsunuz ve karşınıza ne bir hata mesajı ne de içerik çıkıyor; sadece bomboş, kapkara bir beyazlık. WordPress dünyasında bu durum o kadar tanıdık ki kendi adını almış: White Screen of Death, yani “ölümün beyaz ekranı”. İsmi kulağa dramatik gelse de iyi haber şu: beyaz sayfa hatası neredeyse her zaman çözülebilir bir sorundur ve çoğu durumda sebebi birkaç dakika içinde tespit edilebilir.

Bu rehberde beyaz ekranın neden ortaya çıktığını, panele hiç giremiyorsanız bile siteyi nasıl ayağa kaldıracağınızı ve aynı sorunun bir daha kapınızı çalmaması için neler yapmanız gerektiğini sırasıyla anlatıyoruz. Adımları yukarıdan aşağıya uygulayın; çoğu sitede sorun ilk üç başlığı geçmeden çözülür.

Beyaz Sayfa Hatasının Sebepleri

Beyaz ekran, aslında tek bir hata değil; arka planda PHP’nin bir noktada çalışmayı durdurduğunu gösteren bir belirti. WordPress bir sayfayı oluştururken kritik bir hatayla karşılaşır ve çıktıyı tamamlayamazsa, tarayıcıya hiçbir şey gönderemez. Sonuç: bomboş ekran. Bu durumun en sık görülen sebepleri şunlardır:

• PHP bellek limitinin aşılması: Tema, eklenti ya da bir işlem, sunucunun ayırdığı belleği tüketince PHP süreci öldürülür. En yaygın sebeplerden biridir.
• Hatalı kodlanmış veya uyumsuz bir eklenti: Çoğu beyaz ekran vakası, yeni kurulan ya da güncellenen bir eklentiden kaynaklanır. Eklentinin kodu, PHP sürümünüzle uyumsuz olabilir.
• Tema kaynaklı sorunlar: Kötü yazılmış bir functions.php ya da bozuk bir tema dosyası, siteyi tamamen kilitleyebilir.
• Bozuk veya yanlış yapılandırılmış .htaccess dosyası: Hatalı bir yönlendirme kuralı tüm istekleri çökertebilir.
• Eksik ya da zedelenmiş WordPress çekirdek dosyaları: Yarım kalan bir güncelleme veya başarısız bir dosya yüklemesi sonrası ortaya çıkar.
• Hosting kaynaklı kaynak yetersizliği: Özellikle düşük kaynaklı, aşırı doldurulmuş paylaşımlı sunucularda CPU/RAM limitleri site çökmesine yol açabilir.

Sebep listesini gördükten sonra atılacak ilk adım, “görünmez” hatayı görünür kılmaktır. Çünkü hangi eklentinin ya da satırın suçlu olduğunu bilmeden el yordamıyla ilerlemek vakit kaybettirir.

Hata Mesajını Görünür Hale Getirin (Hata Ayıklama)

Canlı sunucularda display_errors genellikle Off konumdadır; bu yüzden ekranda hata mesajı yerine boşluk görürsünüz. İlk işiniz hataları açığa çıkarmak olmalı. FTP veya hosting dosya yöneticisiyle sitenizin kök dizinindeki wp-config.php dosyasını açın ve şu satırı bulun:

define( 'WP_DEBUG', false );

Bu satırı aşağıdaki blokla değiştirin:

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

Buradaki ayrım önemli: WP_DEBUG_LOG, hataları ekranda göstermek yerine wp-content/debug.log dosyasına yazar. WP_DEBUG_DISPLAY ise false bırakılarak ziyaretçilerin hata detaylarını görmesi engellenir. Yani sitenizi tüm dünyaya açmadan, sadece sizin görebileceğiniz bir günlüğe kayıt alırsınız; canlı bir sitede izlenmesi gereken doğru yol budur.

Sayfayı yenileyip hatayı tetikledikten sonra wp-content/debug.log dosyasını açın. Aradığınız satır genellikle şuna benzer:

PHP Fatal error: Allowed memory size of 67108864 bytes exhausted ...
PHP Fatal error: Uncaught Error: Call to undefined function ... in /wp-content/plugins/ornek-eklenti/...

İlk satır bellek yetersizliğine, ikincisi ise plugins/ornek-eklenti klasöründeki bir eklentiye işaret eder. Hata mesajındaki dosya yolu, suçluyu doğrudan adıyla gösterir. Sorunu çözdükten sonra WP_DEBUG değerini tekrar false yapmayı unutmayın.

Hangi belirti hangi sebebe işaret eder?

PHP Bellek Limitini Artırın

Beyaz ekranın en sık görülen tek sebebi bellek yetersizliğidir. WordPress, modern bir tema ve birkaç aktif eklentiyle rahatça çalışabilmek için günümüzde en az 256 MB belleğe ihtiyaç duyar. Buna karşın düşük kaynaklı paylaşımlı paketlerde varsayılan limit hâlâ 32–64 MB’de takılı kalabilir. wp-config.php dosyasına, /* That's all, stop editing! */ satırının üzerine şu iki tanımı ekleyin:

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

Birinci satır sitenin genel bellek limitini, ikinci satır ise yönetim paneli ve görsel işleme gibi ağır işlemler için ayrılan üst sınırı belirler. Bu değişikliğin etkili olması, hosting tarafındaki PHP limitinin de yeterli olmasına bağlıdır. Alastyr’ın WordPress paketlerinde PHP sürüm seçici üzerinden bellek limitini, max_execution_time ve upload_max_filesize gibi değerleri panelden saniyeler içinde yükseltebilir; sunucu kaynaklarınız yeterli geldiğinde sorunu kalıcı olarak ortadan kaldırabilirsiniz.

Bellek limitini artırmak hatayı çözmediyse, sıra suçluyu yakalamaya gelir: önce eklentiler, sonra tema.

Eklenti Kaynaklı Sorunu Tespit Edin

Beyaz ekran genellikle yeni kurulan ya da güncellenen bir eklentiden kaynaklanır. Panele girebiliyorsanız işiniz kolay: Eklentiler ekranından hepsini birden pasifleştirin, site açılıyorsa eklentileri tek tek aktif edip her seferinde siteyi kontrol ederek sorunlu olanı bulun.

Ancak çoğu zaman panele de giremezsiniz. Bu durumda FTP ya da hosting dosya yöneticisiyle wp-content klasörüne girin ve plugins klasörünün adını geçici olarak plugins_eski gibi bir şeyle değiştirin. Bu işlem tüm eklentileri tek hamlede devre dışı bırakır. Eğer siteniz açılıyorsa, sorunun bir eklenti olduğu kesinleşmiştir.

Sonraki adım: klasörün adını eski haline (plugins) geri getirin, ardından içindeki eklenti klasörlerini tek tek yeniden adlandırarak hangisinin siteyi çökerttiğini bulun. Suçluyu tespit edince o eklentiyi silebilir, alternatif bir eklenti arayabilir ya da geliştiricisinden güncel sürümü talep edebilirsiniz.

Tema Kaynaklı Hata Kontrolü

Eklentiler suçlu değilse gözünüzü temaya çevirin. En temiz test, geçici olarak WordPress’in varsayılan temasına (örneğin Twenty Twenty-Four) geçmektir. Panele girebiliyorsanız Görünüm → Temalar üzerinden varsayılan temayı etkinleştirin.

Panele giremiyorsanız FTP ile wp-content/themes klasörüne gidin ve aktif temanızın klasörünü yeniden adlandırın. WordPress, aktif temayı bulamayınca otomatik olarak varsayılan temaya döner. Site açılıyorsa sorun temanızdadır; genellikle de temanın functions.php dosyasındaki bir kod parçasından kaynaklanır. Bu noktada tema geliştiricisiyle iletişime geçmek ya da en son yaptığınız özelleştirmeyi geri almak çözüm olacaktır.

Bozuk .htaccess Dosyasını Onarın

Beyaz ekranla birlikte bazen “500 Internal Server Error” da görürsünüz; bu çoğu zaman bozuk bir .htaccess dosyasının işaretidir. Sitenizin kök dizinindeki .htaccess dosyasını bulun ve adını .htaccess_eski yapın. Site açılıyorsa sorun buradaydı. Ardından WordPress panelinde Ayarlar → Kalıcı Bağlantılar sayfasını açıp hiçbir değişiklik yapmadan Değişiklikleri Kaydet butonuna basın; WordPress temiz ve geçerli bir .htaccess dosyasını sizin için yeniden oluşturacaktır.

WordPress Çekirdek Dosyalarını Yenileyin

Yarım kalan bir güncelleme ya da başarısız bir dosya transferi, çekirdek dosyaları zedeleyerek beyaz ekrana yol açabilir. Bu durumu gidermek için wp-admin ve wp-includes klasörlerini temiz bir kurulumdan yenilemeniz yeterlidir. WordPress’in güncel sürümünü indirin, açın ve sadece bu iki klasörü FTP ile sunucunuza yükleyerek mevcutların üzerine yazın. Bu işlem wp-content klasörüne (yani tema, eklenti ve medya dosyalarınıza) ve veritabanınıza dokunmaz; içeriğiniz güvendedir.

WordPress Kurtarma Modu (Recovery Mode)

WordPress 5.2 sürümünden bu yana, sitede ölümcül (fatal) bir PHP hatası oluştuğunda devreye giren bir güvenlik ağı var: Kurtarma Modu. Bir eklenti ya da tema siteyi çökerttiğinde WordPress bunu algılar ve yönetici e-posta adresinize, içinde özel bir bağlantı bulunan bir uyarı maili gönderir. Konu satırı genellikle “Siteniz teknik bir sorun yaşıyor” şeklindedir.

Bu e-postadaki bağlantıya tıkladığınızda WordPress, sorunlu eklenti veya temayı yalnızca sizin oturumunuz için duraklatır ve sizi yönetim paneline güvenli biçimde alır. Böylece ziyaretçiler beyaz ekran görmeye devam etse de siz panele girip suçluyu devre dışı bırakabilir ve siteyi normale döndürebilirsiniz. Kurtarma Modu’nun çalışması için yönetici e-posta adresinizin geçerli ve erişilebilir olması şarttır; bu yüzden site mailinizi her zaman aktif bir adres olarak tutmakta fayda var.

Hosting Kaynaklı Beyaz Ekran

Yukarıdaki adımların hiçbiri işe yaramıyor ve sorun farklı sitelerde, farklı zamanlarda tekrar ediyorsa gözden kaçırdığınız sebep sunucunun kendisi olabilir. Aşırı doldurulmuş, kaynakları kısıtlı paylaşımlı paketlerde CPU ya da bellek limitine takılan siteler düzenli olarak beyaz ekran verir. Burada eklenti silmek değil, doğru altyapı kalıcı çözümdür.

Alastyr’ın WordPress hosting altyapısı tam da bu noktada fark yaratır. LiteSpeed web sunucusu ve LSCache önbellekleme ile sayfalar düşük kaynak tüketerek hızlı yüklenir; CloudLinux ve CageFS sayesinde her hesap kendi kaynak adasında izole çalışır, yani komşu bir sitenin yükü sizin sitenizi etkilemez. Sunucularımız Intel Xeon Gold işlemciler ve Dell EMC Unity all-flash depolama üzerinde çalışır; tüm altyapı İzmir’deki kendi veri merkezimizde, Türkiye lokasyonunda barındırılır. Bu da Türkiye’den gelen ziyaretçileriniz için düşük gecikme ve istikrarlı performans demektir. Panel üzerindeki PHP sürüm seçiciyle bellek limitini saniyeler içinde yükseltebilir, günlük yedekleme ile beklenmedik bir sorunda sitenizi anında geri alabilirsiniz.

Beyaz Ekranı Önlemek İçin Alışkanlıklar

• Güncellemeleri önce test ortamında deneyin: Eklenti ve tema güncellemelerini, mümkünse bir staging (deneme) kopyasında test edip sonra canlıya alın.
• Düzenli yedek alın: Otomatik günlük yedek, en kötü senaryoda bile birkaç dakikada eski hâle dönmenizi sağlar.
• Güncel ve desteklenen bir PHP sürümü kullanın: Eski PHP sürümleri hem güvenlik açığı hem de uyumsuzluk kaynağıdır.
• Eklenti sayısını makul tutun: Her eklenti potansiyel bir çatışma noktasıdır; gerçekten ihtiyaç duymadıklarınızı kaldırın.
• İtibarlı kaynaklardan eklenti/tema kurun: Korsan ya da bilinmeyen kaynaklı temalar, beyaz ekranın yanı sıra güvenlik riski de taşır.

Sıkça Sorulan Sorular

WordPress beyaz ekran hatası nedir?

Beyaz ekran hatası, teknik adıyla White Screen of Death, sitenizi açtığınızda hiçbir içerik ya da hata mesajı görünmeden karşınıza bomboş bir sayfanın çıkmasıdır. Bunun sebebi, WordPress’in sayfayı oluştururken ölümcül bir PHP hatasıyla karşılaşıp çıktıyı tamamlayamamasıdır. Genellikle eklenti, tema, bellek limiti ya da çekirdek dosya kaynaklı çözülebilir bir sorundur.

Panele hiç giremiyorsam beyaz ekranı nasıl çözerim?

Panele giremiyorsanız FTP veya hosting dosya yöneticisini kullanın. Önce wp-content içindeki plugins klasörünün adını değiştirerek tüm eklentileri pasifleştirin. Site açılırsa sorun bir eklentidedir. Açılmıyorsa aktif temanızın klasörünü yeniden adlandırarak temayı test edin. Bunlar işe yaramazsa .htaccess dosyasını yeniden adlandırın ve çekirdek dosyaları yenileyin.

WP_DEBUG nasıl açılır ve neden gereklidir?

wp-config.php dosyasındaki define WP_DEBUG false satırını WP_DEBUG true olarak değiştirip yanına WP_DEBUG_LOG true ve WP_DEBUG_DISPLAY false ekleyin. Böylece hatalar ziyaretçilere görünmeden wp-content/debug.log dosyasına yazılır. Bu günlük, beyaz ekrana hangi eklenti, tema veya dosyanın yol açtığını dosya yoluyla birlikte size doğrudan gösterir.

WordPress için ne kadar PHP bellek limiti gerekir?

Modern bir tema ve birkaç eklentiyle çalışan güncel bir WordPress sitesi için önerilen bellek limiti en az 256 MB’dir. wp-config.php dosyasına define WP_MEMORY_LIMIT 256M satırını ekleyerek limiti yükseltebilirsiniz. Bu değişikliğin etkili olması için hosting tarafındaki PHP limitinin de yeterli olması gerekir.

Beyaz ekrana en sık hangi sebep yol açar?

Pratikte en sık görülen sebep eklenti kaynaklı çatışmalardır; özellikle yeni kurulan ya da güncellenen, PHP sürümünüzle uyumsuz eklentiler. Onu bellek limitinin aşılması ve tema kaynaklı hatalar takip eder. Bu yüzden çözüm sürecine genellikle önce eklentileri, sonra temayı devre dışı bırakarak başlamak en hızlı yoldur.

Çekirdek dosyaları yenilersem içeriğimi kaybeder miyim?

Hayır. Sadece wp-admin ve wp-includes klasörlerini güncel WordPress kurulumundan yenilediğinizde tema, eklenti ve medya dosyalarınızın bulunduğu wp-content klasörüne ve veritabanınıza dokunulmaz. İçeriğiniz, ayarlarınız ve görselleriniz olduğu gibi kalır. Yine de işlem öncesinde bir yedek almanız önerilir.

Kurtarma Modu (Recovery Mode) nedir ve nasıl çalışır?

WordPress 5.2 ile gelen Kurtarma Modu, sitede ölümcül bir hata oluştuğunda devreye girer ve yönetici e-posta adresinize özel bir giriş bağlantısı içeren bir uyarı maili gönderir. Bu bağlantıya tıkladığınızda sorunlu eklenti veya tema yalnızca sizin oturumunuz için duraklatılır ve panele güvenle girersiniz. Çalışması için site yönetici e-postanızın erişilebilir olması gerekir.

Beyaz ekran hostingden mi kaynaklanıyor?

Hata farklı sitelerde tekrar ediyor, eklenti ve tema testleri sonuç vermiyorsa sebep sunucu kaynaklarının yetersizliği olabilir. Aşırı doldurulmuş paylaşımlı paketlerde CPU ve bellek limitlerine takılan siteler düzenli olarak beyaz ekran verir. LiteSpeed ve CloudLinux tabanlı, hesap başına kaynak izolasyonu sağlayan bir altyapıya geçmek bu tür sorunları kalıcı olarak ortadan kaldırır.

Beyaz ekranın tekrarlamasını nasıl önlerim?

Güncellemeleri önce bir deneme ortamında test edin, düzenli otomatik yedek alın, güncel ve desteklenen bir PHP sürümü kullanın, gereksiz eklentileri kaldırın ve yalnızca itibarlı kaynaklardan tema/eklenti kurun. Bu alışkanlıklar beyaz ekran riskini önemli ölçüde azaltır; günlük yedek ise olası bir sorunda hızlı geri dönüş imkânı sağlar.