WordPress beyaz ekran ve kritik hata çözüm rehberi

WordPress siteniz boş bir ekran gösteriyor veya “Bu web sitesinde kritik bir hata oluştu” mesajı veriyorsa ilk hedef hatayı görünür hâle getirmektir. Rastgele eklenti silmek, PHP sürümünü tekrar tekrar değiştirmek ya da bütün dosyaların izinlerini açmak sorunu büyütebilir. Bu rehber, son değişiklikten başlayarak hatayı daraltmanız ve ziyaretçi erişimini kontrollü biçimde geri getirmeniz için bir yol sunar.

Sorunun kapsamını belirleyin

Ana sayfa, yönetim paneli ve farklı bir içerik sayfasını ayrı ayrı açın. Yalnız belirli bir sayfa bozuluyorsa o sayfadaki bileşen, kısa kod veya şablon öne çıkar. Bütün sayfalar etkileniyorsa ortak yüklenen bir eklenti, tema işlevi veya sunucu tarafındaki değişiklik incelenmelidir. Tarayıcı geliştirici araçlarındaki Network bölümünde yanıtın 200 mü, 500 mü olduğunu kaydedin; boş görünüm tek başına hata kodunu açıklamaz.

Sorunun başladığı saati ve son işlemi not edin. Örneğin bir tema güncellemesinden hemen sonra yaşanan kesinti, aynı anda rastgele yapılan beş değişiklikten daha kolay araştırılır. Elinizdeki yedeğin zamanını kontrol edin; eski yedeği geri yüklemek yeni siparişleri veya içerikleri kaybettirebilir.

Güvenli teşhis sırası

1. Mevcut durumu koruyun. Dosya ve veritabanı yedeği alınabiliyorsa alın. Hatalı durumun kopyası bile inceleme için değerlidir.
2. Kurtarma e-postasını kontrol edin. WordPress bir kurtarma bağlantısı gönderdiyse yalnız kendi alan adınıza ait bağlantıyı kullanın. Bu özel bağlantıyı paylaşmayın.
3. Hata kaydını bulun. Hosting panelindeki PHP hata günlüğünü, ilgili zaman aralığında inceleyin. Dosya yolu, hata türü ve satır numarası birlikte anlam taşır.
4. Son değişikliği izole edin. Panel açılıyorsa şüpheli eklentiyi geçici olarak devre dışı bırakın. Açılmıyorsa dosya yöneticisiyle yalnız ilgili eklenti klasörünü kontrollü biçimde yeniden adlandırmak değerlendirilir.
5. Her adım sonrası deneyin. Bir değişiklik yapıp sonucu kaydedin. Böylece düzelmenin hangi işlemden kaynaklandığı anlaşılır.

Hata kayıtlarını ziyaretçiye göstermeyin

Geliştirme amaçlı günlük tutma ile hataları herkese ekranda gösterme farklı ayarlardır. Üretim sitesinde dosya yolları, sorgular veya kişisel veriler içeren hata çıktısını yayınlamayın. WordPress hata ayıklama sabitlerini kullanmanız gerekiyorsa mevcut tanımları kontrol edin, aynı sabiti iki kez eklemeyin ve işlemi tamamlayınca geçici ayarları kaldırın. Günlük dosyasının web üzerinden indirilememesi de önemlidir.

Eklenti, tema ve PHP ilişkisini değerlendirin

“Undefined function”, bellek sınırı veya sözdizimi hataları aynı çözümü gerektirmez. Eklentinin ihtiyaç duyduğu PHP uzantısı eksik olabilir; eski kod yeni PHP sürümüyle uyumsuz olabilir. Belleği artırmak her hatayı çözmez ve paketin gerçek kaynak sınırını ortadan kaldırmaz. Tema değişikliği yapılacaksa mevcut ayarları koruyun ve işlemi mümkünse test kopyasında deneyin.

Örneğin yalnız ödeme sayfasının açılmaması, tüm eklentileri silmek için yeterli neden değildir. Son ödeme eklentisi güncellemesini, ilgili hata satırını ve ödeme sağlayıcısının bağlantısını birlikte incelemek daha anlamlıdır. Üretimde yaptığınız denemeler sırasında gerçek ödeme tetiklememeye dikkat edin.

Düzeldiğini nasıl anlarsınız?

Yalnız ana sayfanın açılması yeterli değildir. Yönetici girişi, medya yükleme, arama, form gönderimi ve varsa sepet akışını kontrol edin. Önbelleği temizledikten sonra oturumsuz tarayıcıyla tekrar deneyin. Aynı hata günlükte sürüyorsa görünür belirti düzelmiş olsa bile kök neden araştırılmalıdır.

Sık sorulan sorular

Eklentiyi devre dışı bırakmak verilerini siler mi? Çoğu eklentide kaldırma işleminden farklıdır; yine de davranışını ve yedeğini kontrol edin.

PHP sürümünü düşürmeli miyim? Yalnız doğrulanmış uyumsuzluk ve desteklenen sürüm kapsamında geçici geri dönüş düşünülmelidir.

Destek talebine ne yazmalıyım? Etkilenen adresi, başlangıç saatini, son değişikliği ve gizli bilgilerden arındırılmış hata satırını ekleyin.

İlgili teknik kaynak

• WordPress hata ayıklama araçları