Kısa cevap
Beyaz ekran (White Screen of Death), PHP betiğinin herhangi bir çıktı vermeden çökmesi ve hatanın gizlenmesi anlamına gelir. `wp-config.php` dosyasında hata görüntülemeyi açın, mesajı okuyun, ardından eklentileri devre dışı bırakın ve temayı varsayılana geçirin. Çoğu durumda suçlu uyumsuz bir eklenti, tema veya yetersiz PHP belleğidir.
Sorun nasıl anlaşılır
- Site ve yönetim paneli tamamen boş beyaz bir sayfa gösteriyor
- `/wp-admin` girişi oturum açma formunu göstermiyor
- Sayfa yükleniyor ancak içerik veya hata mesajı yok
- Tarayıcıda 500 veya 200 durumu ve boş yanıt gövdesi
- Bir eklenti veya tema güncellemesinden sonra site açılmamaya başladı
En yaygın nedenler
Ölümcül PHP hatası
Bir eklenti veya tema, var olmayan veya PHP sürümüyle uyumsuz bir işlevi çağırır, bu nedenle sayfa çıktısından önce yürütme durur.
Yetersiz PHP belleği
PHP `memory_limit` değerine ulaştığında betik mesaj vermeden sonlanır ve tarayıcı boş bir sayfa gösterir.
Güncelleme sonrası bozuk tema
Kısmen güncellenmiş veya uyumsuz bir tema yüklenirken çöker, bu da hem ön uç hem de yönetim panelini etkiler.
Bozuk çekirdek dosyaları
Kesintiye uğramış WordPress güncellemesi veya başarısız dosya aktarımı eksik PHP dosyaları bırakır.
Barındırma düzeyinde çakışma
PHP sürümünün değiştirilmesi veya zorunlu bir modülün (örneğin `mbstring`) devre dışı bırakılması, görünür bir mesaj olmadan çökmeye neden olur.
Adım adım çözüm
- 1
Her şeyden önce yedek alın
Herhangi bir değişiklik yapmadan önce barındırma paneli veya yedekleme eklentisi aracılığıyla dosya ve veritabanı yedeğini indirin. Yönetim paneline erişiminiz yoksa dosya yedeğini SFTP üzerinden, veritabanını phpMyAdmin veya cPanel'deki yedekleme aracı üzerinden indirin. Bu, bir sorun çıkarsa önceki duruma dönmenizi sağlar.
- 2
Hata görüntülemeyi açın
wp-config.phpdosyasını SFTP veya dosya yöneticisi aracılığıyla açın ve geçici olarakdefine( 'WP_DEBUG', true );vedefine( 'WP_DEBUG_DISPLAY', true );satırlarını ekleyin. Siteyi yenileyin ve artık görünen mesajı okuyun. Hata hala görünmüyorsaphp.iniveya barındırma paneli üzerindendisplay_errorsayarını açın. - 3
Hata günlüğüne bakın
Hata görüntüleme sunucu düzeyinde kapalıysa, site kök dizinindeki
error_logdosyasını veya barındırma panelindeki (günlükler bölümü) kontrol edin. Son satırlar genellikle yürütmenin durduğu dosyayı ve satırı belirtir. Bu bilgi suçluya en hızlı ulaşma yoludur. - 4
Eklentileri yönetim paneli olmadan devre dışı bırakın
SFTP üzerinden
wp-content/pluginsklasörünüplugins-offolarak yeniden adlandırın. Site geri gelirse sorun bir eklentidedir. Ardından klasör adını geri alın ve siteyi çöken eklentiyi bulana kadar eklenti klasörlerini tek tek yeniden adlandırın. - 5
Temayı varsayılana geçirin
Etkin temanın klasörünü
wp-content/themesiçinde örneğintema-offolarak yeniden adlandırın. WordPress, varsayılan tema yüklüyse otomatik olarak ona geçer. Site geri gelirse temayı güncelleyin veya uyumlu bir sürümle değiştirin. - 6
PHP belleğini artırın
wp-config.phpdosyasınadefine( 'WP_MEMORY_LIMIT', '256M' );ekleyin ve barındırma izin veriyorsaphp.iniveya barındırma panelindememory_limitdeğerini yükseltin. PHP sürümünün WordPress sürümünüz için desteklendiğini de kontrol edin. - 7
Dosyalar bozuksa çekirdeği geri yükleyin
Yönetim panelinden veya barındırma paneli üzerinden çekirdeği yeniden indirmeyi başlatın veya
wp-adminvewp-includesklasörlerini ve kök dizindeki temel dosyaları (wp-config.phpvewp-contenthariç) aynı sürümün taze dosyalarıyla manuel olarak değiştirin.wp-contentklasörüne dokunmayın, çünkü temalar, eklentiler ve yüklenen dosyalar oradadır. - 8
Son olarak hata görüntülemeyi kapatın
Site çalışmaya başladığında
WP_DEBUGdeğerinifalseyapın veWP_DEBUG_DISPLAYsatırını kaldırın, böylece ziyaretçiler dahili mesajları görmez. Hataların yine de günlüğe kaydedilmesi gerekiyorsa tamamen kapatmak yerineWP_DEBUGaçık,WP_DEBUG_DISPLAYkapalı veWP_DEBUG_LOGaçık bırakın, böylece hatalarwp-content/debug.logdosyasına kaydedilir.
Hiçbir şey işe yaramazsa
Tüm eklentileri devre dışı bıraktıktan ve temayı değiştirdikten sonra bile beyaz ekran devam ediyorsa, sorun büyük olasılıkla WordPress'in altındadır: hatalı PHP yapılandırması, eksik modül, dolu disk veya bozuk veritabanı. Barındırma panelinde disk kullanımını ve kotayı, ardından PHP sürümünü ve etkin modüller listesini kontrol edin. Site bakım modundaysa kök dizindeki .maintenance dosyasını silin. Bu da işe yaramazsa, bilinen çalışan durumdaki yedeği geri yükleyin ve ardından güncellemeleri her adımdan sonra kontrol ederek tek tek uygulayın.
Tekrarlanmaması için
- Dosya ve veritabanı yedeklerini düzenli olarak alın ve geri yüklemeyi test edin
- Eklentileri ve temayı üretime almadan önce test kopyasında güncelleyin
- PHP ve WordPress'i desteklenen sürümlerde tutun ve `debug.log` dosyasını izleyin
- Kullanmadığınız etkin olmayan eklentileri ve temaları kaldırın
Ne zaman uzmana başvurmalı
SFTP üzerinden dosyalara erişiminiz yoksa, yedeğiniz yoksa veya beyaz ekran her değişiklikten sonra tekrarlıyorsa, IT desteğini aramanız daha iyidir. Onlar, kalıcı veri kaybı riski olmadan sunucu yapılandırmasını ve veritabanını kontrol edebilir.
Web sitesi yapımı · Hızlı, SEO uyumlu, çok dilli web siteleriSık sorulan sorular
Beyaz ekran, sitenin veri kaybettiği anlamına mı gelir?
Hayır. Veritabanı ve dosyalar çoğunlukla bozulmamıştır, çünkü sorun PHP kodunun yürütülmesindeki bir hatadır. Veriler yalnızca yedek olmadan riskli değişiklikler yapılırsa kaybolabilir.
Yönetim paneline giriş yapamıyorsam siteyi düzeltebilir miyim?
Evet, SFTP veya barındırmadaki dosya yöneticisi aracılığıyla. Eklenti ve tema klasörlerini yeniden adlandırarak yönetim panelini atlarsınız ve sorunun onlarda olup olmadığını hemen görürsünüz.
Hata neden ekranda görünmüyor?
Çoğu barındırma sağlayıcısı, ziyaretçilerin dahili ayrıntıları görmemesi için hata görüntülemeyi kapatır. Bu nedenle mesaj yalnızca `WP_DEBUG` ayarını açtığınızda veya `error_log` dosyasına baktığınızda görünür.