WordPress Beyaz Ekran Hatası Çözümü: Hosting ve PHP Taraflı Adım Adım Rehber

WordPress Beyaz Ekran Hatası (White Screen of Death) Nedir?

WordPress sitenize giriyorsunuz ve karşınıza sadece bomboş, bembeyaz bir sayfa çıkıyor. Ne hata mesajı var, ne uyarı, ne de ipucu… İşte bu durum klasik WordPress beyaz ekran hatası ya da diğer adıyla White Screen of Death (WSOD) olarak bilinir. Genellikle PHP tarafında kritik bir hata oluştuğunda ama bu hata ekrana gösterilmediğinde ortaya çıkar. Çoğu zaman sorun; eklenti, tema, PHP sürümü, bellek limiti veya sunucu (hosting) ayarlarıyla ilgilidir.

DCHost tarafında yüzlerce WordPress sitesini yönetirken gördük ki, bu hata ilk bakışta ürkütücü görünse de doğru bir teşhis akışıyla genellikle birkaç adımda çözülebiliyor. Önemli olan, sorunun gerçekten hosting/PHP katmanından mı yoksa sadece WordPress tarafındaki bir eklenti ya da temadan mı kaynaklandığını ayırt edebilmek. Bu rehberde, hem paylaşımlı hosting hem de VPS/dedicated sunucu kullananlar için, beyaz ekran hatasını sunucu ve PHP tarafında sistematik şekilde nasıl teşhis edip çözeceğinizi adım adım anlatacağız.

Ayrıca yazının sonunda, bu hatayı tekrar yaşamamak için almanız gereken önleyici adımları ve DCHost altyapısında pratik olarak kullanabileceğiniz kontrolleri de özetleyeceğiz.

İlk Adım: Sorun Hosting mi, WordPress mi?

Beyaz ekran hatasını çözerken ilk hedefiniz şu olmalı: Problem sunucu/hosting katmanında mı, yoksa WordPress uygulamasında mı? Bunu hızlıca anlamak için birkaç temel kontrol yapabilirsiniz.

1. Farklı Sayfaları ve Admin Panelini Deneyin

Önce aşağıdaki üç testi yapın:

• Ana sayfaya gidin: https://siteadresiniz.com
• Rastgele bir iç sayfaya gidin: https://siteadresiniz.com/ornek-sayfa
• Admin paneline girmeyi deneyin: https://siteadresiniz.com/wp-admin

Çıkan sonuçlar size önemli ipuçları verir:

• Her yerde beyaz ekran varsa: Büyük ihtimalle genel bir PHP hatası, bellek limiti sorunu veya çekirdek dosya/eklenti hatası söz konusudur.
• Sadece admin paneli beyaz ekran veriyorsa: Genellikle eklentiler, rol/izin eklentileri veya sadece yönetim arayüzünü etkileyen bir kod hatası vardır.
• Sadece belirli sayfalar beyaz ekran veriyorsa: İlgili sayfada kullanılan kısa kodlar (shortcode), sayfa oluşturucu (page builder) veya özel tema şablonları şüphelidir.

2. Tarayıcı Konsolu ve HTTP Durum Kodu Kontrolü

Beyaz ekran her zaman 500 hatası anlamına gelmez ama çoğunlukla arka planda bir 5xx HTTP hata kodu saklıdır. Tarayıcıda Geliştirici Araçları&aposnı (F12) açıp Network sekmesinden isteğin durum kodunu kontrol edin. HTTP durum kodları hakkında daha derin bir okuma yapmak isterseniz, 301, 404 ve 5xx HTTP durum kodlarını anlatan detaylı rehberimizi inceleyebilirsiniz.

3. Basit Bir PHP Dosyası ile Sunucuyu Test Edin

Hosting hesabınızda kök dizine (genellikle public_html) küçük bir test dosyası oluşturun:

<?php
phpinfo();

Bunu info.php olarak kaydedin ve tarayıcıdan https://siteadresiniz.com/info.php adresine gidin.

• PHP bilgi ekranı düzgün geliyorsa: PHP motoru ve sunucu genel olarak çalışıyor, sorun büyük ihtimalle WordPress tarafında.
• Bu dosyada da beyaz ekran veya 500 hatası görüyorsanız: Sorun hosting veya PHP yapılandırmasında olabilir (bozuk PHP, modül eksikliği, global konfigürasyon vb.).

Hosting Kaynak Limitleri: Bellek ve CPU Yetersizliği

WordPress beyaz ekran hatasının en sık gördüğümüz nedenlerinden biri, özellikle paylaşımlı hosting ortamlarında bellek (RAM) ve CPU limitlerine takılmak. CloudLinux gibi izolasyon katmanları kullanılan platformlarda, limit aşımı olduğunda PHP süreci sessizce sonlandırılabilir ve kullanıcı sadece beyaz ekran görür.

1. cPanel Kaynak Limitlerini Kontrol Edin

DCHost üzerinde cPanel kullanıyorsanız, Kaynak Kullanımı (Resource Usage) bölümünden son 24 saat veya son birkaç gün içindeki CPU, RAM, IO ve EP (eş zamanlı proses) limitlerinizi kontrol edebilirsiniz. Bu konuda detaylı bir arka plan için, cPanel'de kaynak limitleri ve "Resource Limit Reached" hatasını açıklayan rehberimize mutlaka göz atın.

Grafiklerde sık sık kırmızı alanlar, "fault" ya da "limit reached" uyarıları görüyorsanız, beyaz ekran hatanız PHP sürecinin limitlere çarpıp düşmesinden kaynaklanıyor olabilir.

2. PHP memory_limit Değerini Artırmak

WordPress çekirdeği, modern temalar ve özellikle WooCommerce gibi eklentiler, varsayılan 64M bellek limitiyle sağlıklı çalışmayabilir. Bu durumda beyaz ekran genellikle Allowed memory size of XXX bytes exhausted şeklinde bir PHP hatasıyla tetiklenir, fakat hata ekrana yansımadığı için sadece beyaz ekran görürsünüz.

memory_limit değerini artırmanın birkaç yolu vardır:

• cPanel > Select PHP Version veya MultiPHP INI Editor üzerinden memory_limit değerini 256M veya 512M yapmak.
• wp-config.php içine aşağıdaki satırı eklemek:
  define( 'WP_MEMORY_LIMIT', '256M' );
• .htaccess içine (Apache kullanıyorsanız) şu satırı eklemek:
  php_value memory_limit 256M

Bu değişikliklerden sonra sorun düzeliyorsa, beyaz ekranınızın arkasındaki sebep büyük ihtimalle yetersiz bellek limitidir. Sürekli limit artırmak yerine, eklenti/tema optimizasyonu ve gerekirse paket yükseltme veya VPS'e geçiş gibi seçenekleri de değerlendirmelisiniz.

Özellikle paylaşımlı hosting kullanıyorsanız, kaynak limitleriyle ilgili daha detaylı ipuçları için paylaşımlı hostingde "Resource Limit Reached" hatasını önleme rehberimize bakmanız faydalı olacaktır.

3. max_execution_time ve Zaman Aşımı Sorunları

Uzun süren sorgular veya büyük veri işleyen eklentiler (yığın içe aktarma, yedek alma, toplu ürün güncelleme gibi) max_execution_time limitine takıldığında da beyaz ekran görülebilir. PHP betiği zaman aşımına uğrar ve herhangi bir çıktı üretmeden sonlanır.

cPanel PHP ayarları üzerinden max_execution_time değerini 120 veya 180 saniyeye yükseltmek, ağır işlemler sırasında bu sorunu azaltabilir. Ancak bu sadece semptomu hafifletir; asıl yapılması gereken, sitenin ağırlaşmasına neden olan sorguları ve eklentileri analiz etmektir.

PHP Hatalarını Görünür Yapmak: debug.log ve error_log

Beyaz ekran hatasını çözmenin kilit adımı, gerçekte hangi PHP hatasının oluştuğunu görmek. Sunucu tarafında hata gösterimini açmadan hareket etmek, karanlıkta yürümeye benziyor.

1. WordPress Hata Ayıklama Modunu Açmak

wp-config.php dosyanızda aşağıdaki tanımları ekleyin veya düzenleyin:

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

Bu ayarlar sayesinde:

• Hata ve uyarılar ekrana basılmaz (kullanıcı görmez).
• Tüm hatalar wp-content/debug.log dosyasına kaydedilir.

Bir kez daha beyaz ekranı tetikleyin ve ardından debug.log dosyasını inceleyin. Çoğu zaman, sorunu doğrudan işaret eden fatal error satırları göreceksiniz (örneğin belirli bir eklenti dosyasında "Call to undefined function" veya "Allowed memory size exhausted" gibi).

2. Sunucu error_log Dosyalarını Kontrol Edin

cPanel veya DirectAdmin gibi panellerde, sitenize ait error_log dosyaları genellikle web kök dizininde veya logs klasörü altında bulunur. Hata çözümü sırasında bu logları düzenli olarak kontrol etmek, WordPress dışı PHP hatalarını da görmenizi sağlar (örneğin başka bir dizindeki script, cron job veya CLI komutları).

Eklenti ve Tema Çakışmaları: En Klasik WSOD Nedeni

Gerçek dünyada karşılaştığımız WordPress beyaz ekran hatalarının büyük bölümü, yanlış güncellenen veya uyumsuz eklenti/tema kaynaklı. Özellikle yeni bir eklenti kurduktan, tema değiştirdikten veya toplu güncelleme yaptıktan sonra beyaz ekranla karşılaştıysanız, ilk şüpheliniz burası olmalı.

1. Tüm Eklentileri Toplu Olarak Devre Dışı Bırakma

Admin paneline giremiyorsanız bile, FTP veya Dosya Yöneticisi ile eklentileri devre dışı bırakabilirsiniz:

1. wp-content/plugins klasörünün adını örneğin plugins-disabled yapın.
2. Siteyi yenileyin. Eğer site açılıyorsa, sorun büyük ihtimalle eklentilerden biriyle ilgilidir.
3. Klasörü tekrar plugins olarak geri adlandırın.
4. İçerideki eklenti klasörlerinin adını tek tek değiştirerek hangi eklentinin soruna yol açtığını bulun.

Problemli eklentiyi tespit ettikten sonra ya önceki sürüme dönmeli, ya alternatif bir eklenti kullanmalı, ya da eklenti geliştiricisinden güncel bir sürüm beklemelisiniz.

2. Temayı Değiştirerek Test Etmek

Bazen sorun eklentide değil, kullanılan temadadır. Özellikle yoğun sayfa oluşturucu (page builder) içeren, kendi framework'ünü kullanan temalarda PHP sürüm değişikliğinden sonra hatalar sık görülür.

FTP veya Dosya Yöneticisi ile wp-content/themes klasörüne gidip aktif temanın klasör adını geçici olarak değiştirirseniz, WordPress otomatik olarak varsayılan bir temaya (örneğin Twenty Twenty-Three) geçmeye çalışacaktır. Site bu şekilde açılıyorsa, sorun temaya özgüdür.

3. Bu İşlemleri Canlı Sitede Değil, Staging'te Yapmak

Üretim sitenizde (canlı ortam) bu tür denemeler kullanıcılarınızı etkileyebilir. Özellikle e-ticaret veya yoğun trafik alan sitelerde, denemeleri bir staging (önizleme) ortamında yapmak çok daha güvenlidir. Bunun için, WordPress staging ortamı kurulumunu adım adım anlatan rehberimize göz atabilirsiniz.

PHP Sürümü Uyumsuzlukları: Çok Eski ya da Çok Yeni PHP

WordPress çekirdeği ve eklentileriniz belirli bir PHP sürümü aralığı ile test edilir. Çok eski (örneğin PHP 5.6) veya çok yeni ama henüz tüm eklentilerle test edilmemiş bir sürüme geçtiğinizde, beyaz ekranla karşılaşmanız sürpriz değil.

1. Hangi PHP Sürümünü Kullandığınızı Öğrenin

Az önce oluşturduğunuz info.php dosyası üzerinden veya cPanel'deki PHP Selector / PHP Manager ekranından aktif PHP sürümünüzü öğrenin. WordPress için bugün pratikte önerilen sürümler, genellikle PHP 8.0 ve üzeri (desteklenen en güncel kararlı sürüm) aralığıdır; ancak kullandığınız temanın ve eklentilerin bu sürümle uyumlu olduğundan emin olmanız gerekir.

2. cPanel / DirectAdmin ile PHP Sürümü Değiştirmek

DCHost altyapısında her site için ayrı PHP sürümü seçebilmeniz için çoklu PHP yönetimi kullanılır. Aynı sunucu üzerindeki farklı siteler farklı PHP sürümleriyle çalışabilir. Bunun nasıl yönetileceğini merak ediyorsanız, cPanel ve DirectAdmin'de çoklu PHP sürümü yönetimi rehberimize göz atabilirsiniz.

Beyaz ekran hatasını çözerken, şu iki senaryo sık görülür:

• Eski bir sitede PHP 5.x/7.x sürümünden 8.x'e geçersiniz ve bazı eski eklentiler "Call to undefined function" veya "Deprecated" uyarılarından dolayı fatal error üretir.
• Tam tersi; çok eski bir PHP sürümünde modern bir eklentiyi çalıştırmaya çalışırsınız ve "syntax error, unexpected" gibi hatalar alırsınız.

Bu durumlarda yapılacak en mantıklı hareket, sorunun kaynağını bulurken geçici olarak daha uyumlu bir PHP sürümüne dönmek; ardından aşamalı bir güncelleme ve temizleme stratejisi uygulamaktır. PHP 8.x'e geçerken dikkat edilmesi gereken noktaları derli toplu görmek isterseniz, PHP 8.x yükseltme kontrol listemizi mutlaka okuyun.

.htaccess, Dosya İzinleri ve Bozulmuş Çekirdek Dosyalar

Bazen sorun ne eklentide, ne temada, ne de PHP sürümünde olur. Özellikle manuel taşıma, yarım kalan FTP yüklemeleri veya yanlış güvenlik eklentisi ayarları sonrası .htaccess dosyası, dosya izinleri veya WordPress çekirdek dosyaları bozulabilir.

1. .htaccess Dosyasını Sıfırlamak

Apache tabanlı sunucularda, .htaccess dosyasındaki küçük bir yazım hatası bile beyaz ekrana yol açabilir. Sorunu test etmek için:

1. Kök dizindeki (public_html veya sitenizin ana klasörü) .htaccess dosyasını .htaccess.bak şeklinde yeniden adlandırın.
2. Siteyi yenileyin. Eğer açılıyorsa, sorun .htaccess içeriğindedir.
3. WordPress varsayılan .htaccess içeriğini kullanmak için admin paneline erişebiliyorsanız Kalıcı Bağlantılar (Permalinks) sayfasını kaydedin; panel yoksa aşağıdaki varsayılan içeriği yeni bir .htaccess içine ekleyin:

# BEGIN WordPress
RewriteEngine On
RewriteBase /
RewriteRule ^index.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress

2. Dosya İzinlerini Kontrol Etmek

Yanlış dosya izinleri de PHP'nin dosyalara erişememesine ve buna bağlı fatal error'lara neden olabilir. Temel olarak:

• PHP dosyaları için 644 izni yeterlidir.
• Klasörler için 755 izni kullanılmalıdır.

777 gibi herkesin yazabildiği izinler hem güvenlik açığı hem de beklenmedik hatalar doğurabilir; uzak durmanızı öneririz.

3. WordPress Çekirdeğini Yeniden Yüklemek

Bazı durumlarda wp-admin veya wp-includes klasörlerinde eksik/bozuk dosyalar beyaz ekrana yol açabilir. Çözüm için:

1. WordPress'in aynı sürümünü resmi siteden indirin.
2. Arşivi açın ve wp-admin ile wp-includes klasörlerini sunucudaki klasörlerin üzerine yazın.
3. wp-content klasörüne dokunmayın (tema, eklenti ve yüklemeler burada duruyor).

Bu işlem, veritabanınıza veya içeriklerinize dokunmadan sadece çekirdek dosyaları yeniler. İşleme başlamadan önce mutlaka bir yedek almanız gerektiğini unutmayın. Yedekleme tarafında yol gösterici bir rehbere ihtiyacınız varsa, WordPress yedekleme stratejileri ve otomatik yedekleme rehberimize göz atabilirsiniz.

Veritabanı ve Önbellek Kaynaklı Beyaz Ekran Senaryoları

Daha az görülse de, bazı veritabanı hataları ve nesne önbelleği (object cache) sorunları da beyaz ekran üretebilir.

1. Veritabanı Bağlantısını ve Tablo Sağlığını Kontrol Edin

wp-config.php dosyanızda veritabanı adı, kullanıcı adı, parola ve sunucu adresi (DB_HOST) bilgilerini kontrol edin. Özellikle siteyi yeni sunucuya taşıdıysanız, burada yapılan küçük bir yazım hatası bile sitenin çökmesine neden olabilir.

WordPress'in dahili onarım ekranını kullanmak için şu adımı da uygulayabilirsiniz:

1. wp-config.php içine şu satırı ekleyin:
   define( 'WP_ALLOW_REPAIR', true );
2. Tarayıcıdan https://siteadresiniz.com/wp-admin/maint/repair.php adresine gidin.
3. Tabloları onarmayı ve optimize etmeyi deneyin.
4. İşlem bittikten sonra güvenlik için bu satırı wp-config.php dosyanızdan kaldırın.

2. Nesne Önbelleği (Redis/Memcached) ve object-cache.php

Performans için Redis veya Memcached tabanlı nesne önbelleği kullanan WordPress sitelerinde, yanlış yapılandırılmış veya çökmiş bir önbellek katmanı da fatal error üretebilir. Şu adımları deneyin:

• wp-content klasöründeki object-cache.php dosyasını geçici olarak yeniden adlandırın veya silin.
• Redis/Memcached servisini DCHost kontrol panelinden veya VPS'te systemctl üzerinden yeniden başlatın.
• İlgili önbellek eklentisini devre dışı bırakıp siteyi test edin.

Eğer beyaz ekran sorununuz kayboluyorsa, önbellek katmanınızı yeniden kurmanız veya ilgili eklentiyi güncellemeniz gerekebilir.

DCHost Üzerinde Pratik Sorun Giderme Akışı

Yukarıdaki tüm adımları bir araya getirince, DCHost üzerinde barınan WordPress siteleri için pratik bir beyaz ekran hata çözüm akışı şöyle özetlenebilir:

1. Tarayıcıdan HTTP durum kodunu ve sitenin sadece belirli sayfalarda mı yoksa her yerde mi beyaz ekran verdiğini kontrol edin.
2. info.php ile PHP motorunun genel olarak çalışıp çalışmadığını test edin.
3. cPanel'de Kaynak Kullanımı ekranından CPU, RAM, IO, EP limitlerini inceleyin.
4. PHP ayarlarından memory_limit ve max_execution_time değerlerini makul şekilde yükseltin.
5. wp-config.php içinden WP_DEBUG ve WP_DEBUG_LOG ayarlarını etkinleştirip debug.log dosyasını inceleyin.
6. Eklentileri toplu olarak devre dışı bırakıp sorunun devam edip etmediğini test edin; ardından temayı değiştirerek aynı testi tekrarlayın.
7. .htaccess dosyasını sıfırlayın, dosya izinlerini 644/755 olacak şekilde düzenleyin.
8. Gerekirse WordPress çekirdek dosyalarını (wp-admin ve wp-includes) yeniden yükleyin.
9. Veritabanı bağlantı bilgilerini ve tablo sağlığını kontrol edin; gerekiyorsa WordPress onarım ekranını kullanın.

Bu adımların çoğu, DCHost yönetim paneli ve cPanel araçları sayesinde birkaç dakikada uygulanabilecek düzeydedir. Yine de takıldığınız noktada teknik ekibimize ekran görüntüsü ve mümkünse debug.log içeriği ile ulaşmanız, çözümü ciddi şekilde hızlandırır.

Bu Hata Tekrar Yaşanmasın: Önleyici Adımlar

WordPress beyaz ekran hatasını bir kez çözdükten sonra, asıl önemli olan tekrar yaşamamak için ne yapacağınız. Özellikle üretim ortamında çalışan, gelir üreten sitelerde önleyici bakım hayati önem taşır.

1. Sağlam Bir Yedekleme Stratejisi Kurun

Her büyük güncelleme (WordPress çekirdeği, tema, büyük eklenti sürümleri, PHP yükseltmesi vb.) öncesinde mutlaka tam dosya + veritabanı yedeği almalısınız. Yedekleri sadece aynı sunucuda değil, harici bir konumda da saklamak en güvenli yöntemdir. Bunun için, WordPress yedekleme stratejileri rehberimizde anlattığımız otomatik yedekleme ve geri yükleme yöntemlerini uygulayabilirsiniz.

2. Güncellemeleri Önce Staging Ortamında Test Edin

Özellikle WooCommerce veya özel geliştirmeli sitelerde, güncellemeleri doğrudan canlı ortamda yapmak risklidir. Staging ortamı kullanarak:

• Yeni tema ve eklentileri gerçek verilerinizle test edebilirsiniz.
• PHP sürümü yükseltmesini önce staging üzerinde deneyip hataları görebilirsiniz.
• Beyaz ekran veya kritik hata oluşsa bile canlı siteniz etkilenmez.

Staging kurulumunu manuel yapmak isterseniz, WordPress staging ortamı kurulum rehberimiz size adım adım yol gösterecektir.

3. Kaynak Kullanımını ve Hata Loglarını Periyodik Olarak İzleyin

Kaynak limitlerine her gün toslayan bir site, er ya da geç beyaz ekran veya yavaşlık problemleri yaşar. cPanel'deki kaynak kullanım raporlarını ve hata loglarını belli aralıklarla kontrol ederek:

• Bozulan veya hataya düşen eklentileri erken fark edebilirsiniz.
• Aşırı kaynak tüketen sorgu veya cron işleri hakkında ipuçları yakalayabilirsiniz.
• Gerekirse hosting paketinizi zamanında yükseltip daha güçlü bir VPS veya dedicated sunucuya geçme kararını önceden planlayabilirsiniz.

4. Sunucu Tarafı Optimizasyonları İhmal Etmeyin

PHP-FPM, OPcache, nesne önbelleği (Redis/Memcached) ve veritabanı ayarları doğru yapılandırıldığında, hem performans artar hem de ani çökme ve beyaz ekran riskleri azalır. Bu konularla ilgileniyorsanız, WordPress için sunucu tarafı optimizasyon rehberimizde PHP-FPM, OPcache, Redis ve MySQL tarafında uygulayabileceğiniz pek çok pratik ayarı bulabilirsiniz.

Özet ve Yol Haritası

WordPress beyaz ekran hatası, dışarıdan bakıldığında "hiçbir şey olmuyor" gibi görünse de, aslında arka planda çok net bir sebebi olan bir PHP fatal error problemidir. Bu nedenle, panik yapmak yerine sistematik bir şekilde şu soruları sormanız yeterli:

• Bu bir hosting/kaynak sorunu mu (bellek, CPU, PHP versiyonu)?
• Yoksa WordPress katmanında bir problem mi (eklenti, tema, bozuk çekirdek, veritabanı)?
• Hangi adımı attıktan sonra bu sorun ortaya çıktı (update, taşıma, PHP yükseltme)?

Bu rehberde anlattığımız adımları takip ettiğinizde, çoğu WSOD vakasını 20–30 dakika içinde teşhis edip çözebilirsiniz. Yine de takıldığınız bir nokta olursa, DCHost üzerinde barındırılan siteleriniz için destek talebi açarken mümkün olduğunca detaylı bilgi (en son yaptığınız işlem, yaklaşık saat, mümkünse debug.log içeriği ve ekran görüntüsü) paylaşırsanız, teknik ekibimiz hem daha hızlı hem de daha isabetli müdahale edebilir.

WordPress sitenizin sürdürülebilir ve öngörülebilir şekilde çalışması için, beyaz ekranı tek seferlik geçici bir sorun olarak değil, altyapınızı ve süreçlerinizi gözden geçirmek için bir uyarı işareti olarak okumanızda fayda var. Yedekleme, staging, kaynak izleme ve düzenli bakım adımlarını oturttuğunuzda, WSOD sizin için nadir ve kolay yönetilebilir bir durum haline gelecektir.