Beyaz ekran hatasını giderme

WordPress ve PHP'de Beyaz Ekran Nedir ve Neden Oluşur?

Beyaz Ekran (White Screen of Death), WordPress sitesi sahiplerinin ve PHP uygulamalarının karşılaştığı en yaygın sorunlardan biridir. Bu sorunla karşılaştığınızda, site içeriği yerine yalnızca tamamen boş ve beyaz bir sayfa görürsünüz. Bu durum genellikle, sessizce (silent) çalışan ve kullanıcıya herhangi bir hata mesajı göstermeyen bir PHP hatası nedeniyle oluşur.

Beyaz ekranın başlıca nedenleri şunlardır: bir eklenti veya temadaki ölümcül (fatal) hata, PHP'ye ayrılan bellek yetersizliği (memory limit), functions.php veya wp-config.php dosyalarında BOM karakteri veya fazladan boşluk bulunması ve bazen de hosting veya sunucu ayarlarıyla ilgili sorunlar. Bu makalede, bu hatayı pratik ve adım adım nasıl tespit edip düzelteceğinizi öğreneceksiniz.

Adım 1: PHP Hata Gösterimini Etkinleştirme

Beyaz ekranı düzeltmenin ilk adımı, gerçek hatayı görmektir. WordPress, sunucunun hassas bilgilerini ifşa etmemek için varsayılan olarak hata gösterimini devre dışı bırakır. Hata gösterimini geçici olarak etkinleştirmek için wp-config.php dosyasını düzenlemeniz gerekir.

Hata Gösterimi için wp-config.php'yi Düzenleme

SSH veya hosting dosya yöneticisini kullanarak wp-config.php dosyasını açın ve aşağıdaki satırı tam olarak /* That's all, stop editing! Happy blogging. */ satırından hemen önce ekleyin:

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

Bu ayarlarla hatalar wp-content/debug.log dosyasına kaydedilir ancak sayfada görüntülenmez. Şimdi site adresini açın ve ardından log dosyasını inceleyin:

tail -f wp-content/debug.log

Fatal error: Allowed memory size of 67108864 bytes exhausted gibi bir hata görürseniz, sorun bellek yetersizliğinden kaynaklanıyor demektir; buna üçüncü bölümde değineceğiz. Parse error veya syntax error gibi başka bir hata görürseniz, sorun belirli bir PHP dosyasından kaynaklanıyordur.

Adım 2: Eklentileri ve Temayı Devre Dışı Bırakma

Beyaz ekran vakalarının çoğu, bir eklentinin veya temanın WordPress çekirdeğiyle ya da diğer eklentilerle çakışmasından kaynaklanır. Hangisinin suçlu olduğunu tespit etmek için bunları tek tek devre dışı bırakmanız gerekir.

FTP veya SSH Üzerinden Eklentileri Devre Dışı Bırakma

En basit yöntem, wp-content/plugins klasörünün adını değiştirmektir. Bu şekilde WordPress hiçbir eklentiyi yüklemez:

mv wp-content/plugins wp-content/plugins-disabled

Şimdi siteyi açın. Beyaz ekran düzeldiyse, sorun eklentilerden birindedir. Suçlu eklentiyi bulmak için klasörü orijinal adına geri getirin ve ardından eklentileri WordPress yönetim panelinden tek tek devre dışı bırakın. Yönetim paneline erişiminiz yoksa, eklentileri veritabanı üzerinden devre dışı bırakabilirsiniz:

UPDATE wp_options SET option_value = 'a:0:{}' WHERE option_name = 'active_plugins';

Bu sorguyu phpMyAdmin'de veya MySQL komut satırından çalıştırın. Bundan sonra tüm eklentiler devre dışı kalır ve bunları tek tek etkinleştirebilirsiniz.

Varsayılan Temayı Test Etme

Sorun eklentiden kaynaklanmıyorsa, temayı değiştirin. FTP üzerinden, etkin temanın klasörünü wp-content/themes içinde yeniden adlandırın. WordPress otomatik olarak varsayılan temaya (Twenty Twenty-Four veya benzeri) geri döner:

mv wp-content/themes/my-theme wp-content/themes/my-theme-disabled

Site düzeldiyse, sorun temanızdan kaynaklanıyordur. Genellikle hata, temanın functions.php dosyasında oluşur. Bu dosyayı açın ve kapanış ?> etiketinden sonra boşluk veya yeni satır olup olmadığına bakın. Bu etiketten sonra tek bir boşluk karakteri bile headers already sent hatasına ve dolayısıyla beyaz ekrana neden olabilir.

Adım 3: PHP'ye Ayrılan Belleği Artırma

Bellek yetersizliği, yoğun eklentiler kullanan WordPress sitelerinde beyaz ekranın başlıca nedenlerinden biridir. PHP'nin varsayılan bellek miktarı genellikle 64 veya 128 MB'tır ve modern siteler için yeterli değildir.

wp-config.php'de memory_limit Değerini Artırma

En basit yol, wp-config.php dosyasına aşağıdaki satırı eklemektir:

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

Bu değer, WordPress için belleği 256 megabayta çıkarır. Siteniz Page Builder veya çok ürünlü WooCommerce gibi yoğun eklentiler kullanıyorsa, 384 hatta 512 megabayta ihtiyacınız olabilir:

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

php.ini'de Belleği Artırma

php.ini dosyasına erişiminiz varsa (yönetilen hostinglerde genellikle kontrol panelindeki PHP Ayarları bölümünden), aşağıdaki değeri değiştirin:

memory_limit = 256M

Değişiklikten sonra PHP veya web sunucusu servisini yeniden başlatın:

sudo systemctl restart php8.2-fpm

Değişikliklerin uygulandığından emin olmak için site köküne info.php adında bir test dosyası oluşturabilirsiniz:

<?php phpinfo(); ?>

Ardından yourdomain.com/info.php adresini açın ve memory_limit değerini kontrol edin. Testten sonra bu dosyayı mutlaka silin çünkü sunucunun hassas bilgilerini gösterir.

php_value memory_limit 256M

Adım 4: WordPress Çekirdek Dosyalarını Kontrol Etme

Yukarıdaki adımlar işe yaramadıysa, WordPress çekirdek dosyaları zarar görmüş olabilir. Bu genellikle eksik bir güncelleme veya hack saldırısından sonra meydana gelir.

WordPress Çekirdek Dosyalarını Yeniden Yükleme

WordPress yönetim panelinden Panel → Güncellemeler yolunu izleyin ve "Tekrar Yükle" düğmesine tıklayın. Yönetim paneline erişiminiz yoksa, çekirdek dosyaları manuel olarak değiştirin:

1. En son WordPress sürümünü wordpress.org adresinden indirin.
2. wp-admin ve wp-includes klasörlerindeki dosyaları yeni sürümle değiştirin.
3. Site kökündeki index.php, wp-blog-header.php ve wp-settings.php dosyalarını değiştirin.

Eklentilerinizi, temalarınızı ve yüklediğiniz dosyaları içerdiği için wp-content klasörünü değiştirmemeniz önemlidir.

Dosya İzinlerini Kontrol Etme (Permissions)

Yanlış dosya izinleri de beyaz ekrana neden olabilir. WordPress için standart izinler şu şekildedir:

find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;

Bu komutları site kökünden çalıştırın. Sorun dosya sahipliğinden kaynaklanıyorsa, sahibi değiştirebilirsiniz:

chown -R www-data:www-data /var/www/your-site

Kullanıcı adı ve grup, hosting sağlayıcınıza bağlı olarak değişebilir (örneğin nginx veya apache).

Adım 5: Sunucu Loglarını Kontrol Etme

Yukarıdaki yöntemlerin hiçbiri işe yaramadıysa, sunucu loglarını incelemelisiniz. PHP hata logları genellikle şu konumda bulunur:

/var/log/php_errors.log

Veya paylaşımlı hostinglerde, kullanıcı hesabınızdaki logs klasöründe. Son hataları görmek için:

tail -n 50 /var/log/php_errors.log

Ayrıca web sunucusu (Apache veya Nginx) hata loglarını da kontrol edin:

# Apache için
tail -f /var/log/apache2/error.log

# Nginx için
tail -f /var/log/nginx/error.log

Bu loglar genellikle hatanın daha ayrıntılı bilgisini, hatanın oluştuğu dosya adı ve satır numarası dahil olmak üzere gösterir.

Özet ve Tekrar Oluşmasını Önleme

WordPress ve PHP'deki beyaz ekran genellikle şu dört adımı izleyerek çözülür: hata gösterimini etkinleştirme, eklentileri ve temayı devre dışı bırakma, PHP belleğini artırma ve çekirdek dosyaları kontrol etme. Bu sorunun tekrar oluşmasını önlemek için şunları öneririm:

• Eklentileri veya temaları güncellemeden önce sitenizin tam yedeğini alın.
• Sunucu yükünü azaltmak için güvenilir bir önbellek eklentisi kullanın.
• Gereksiz eklentileri kaldırın; her ekstra eklenti bellek tüketir.
• WP_MEMORY_LIMIT değerini baştan 256M olarak ayarlayın.
• Tema ve eklenti dosyalarını uygun bir editörle düzenleyerek gizli karakterlerin girmesini önleyin.

Tüm bu adımlara rağmen hâlâ beyaz ekran görüyorsanız, sorun hosting altyapınızdan kaynaklanıyor olabilir. Bu durumda, aynı sunucudaki diğer sitelerin de sorun yaşayıp yaşamadığını kontrol edin. Siteniz paylaşımlı hostingdeyse ve sorun sunucu kaynaklarından kaynaklanıyorsa, planınızı yükseltmeniz veya daha yüksek kaynaklı bir hizmete geçmeniz gerekebilir. ServerNet olarak, WordPress siteleri için ihtiyaçlarınıza göre seçebileceğiniz çeşitli hosting planları sunuyoruz.

Son olarak, beyaz ekranın çözülebilir bir sorun olduğunu ve sistematik bir yaklaşımla 30 dakikadan kısa sürede tespit edilip düzeltilebileceğini unutmayın. Anahtar nokta, gerçek hatayı görmeden asla rastgele değişiklikler yapmamaktır; çünkü bu durumu daha da kötüleştirebilir.