WordPress sitenizde “Kritik hata” mesajı

debug.log’u okumak: son satır ne söylüyor

WordPress sürümüne göre ekranda “kritik hata” mesajı ya da benzer bir ifade görünür; arkasında, günlükteki işe yarar satır PHP Fatal error ile başlar. Satırda geçen yol suçluyu gösterir: eklenti için wp-content/plugins/eklenti-adi/, tema için wp-content/themes/tema-adi/. En sık karşılaştığım mesajlar:

• Uncaught Error: Call to undefined function: eklenti, sunucunun PHP sürümünde artık bulunmayan ya da bağlı olduğu ve devre dışı bırakılmış bir eklentiye ait bir fonksiyonu çağırıyor — örneğin WooCommerce kapalıyken bir WooCommerce eklentisi.
• Allowed memory size of … bytes exhausted: bellek sınırına ulaşıldı. WP_MEMORY_LIMIT değerini artırmak siteyi açar, ama bu kadar belleği neyin tükettiğini bulmak gerekir.
• Cannot redeclare: iki eklenti ya da iki kez kurulmuş bir eklenti aynı fonksiyonu tanımlıyor.
• Failed opening required: bir dosya eksik; yarıda kalmış bir güncellemenin tipik işareti. Eklentinin aynı sürümünü yeniden kurmak çoğu zaman yeterlidir.
• syntax error, unexpected: bir dosya elle değiştirilmiş; çoğunlukla yönetim panelindeki dosya düzenleyiciyle temanın functions.php dosyası.

FTP erişimi yoksa: kurtarma modu ve sınırları

5.2 sürümünden beri, bir eklenti ya da tema ölümcül bir hataya yol açtığında WordPress, yönetici e-posta adresine kurtarma modunda giriş bağlantısı içeren bir ileti gönderir. Bu bağlantı, sorunlu öğeyi duraklatarak yönetim panelini açar; böylece FTP olmadan devre dışı bırakabilirsiniz. Bağlantı geçicidir ve yönetici adresi güncel değilse ya da site e-posta gönderemiyorsa hiç gelmez. Bu durumda eklenti klasörünü FTP ile ya da barındırma firmasının dosya yöneticisinden yeniden adlandırmak en güvenli yol olmaya devam eder.

Kritik hata yalnızca sepet ya da ödeme sayfasında görünüyorsa, suçlu neredeyse her zaman yalnızca bu adımda çağrılan ödeme ağ geçidi ya da bir kargo eklentisidir: bkz. WooCommerce ödeme sorunu. Aynı belirti başka bir platformda görülüyorsa, mekanizma 500 hatası nereden gelir sayfasında anlatılıyor.

En sık görülen nedenler

Bir WordPress sitesinde kritik hata, büyük çoğunlukla eklentiler arasındaki bir çakışmadan ya da bir eklenti/temanın sunucunun PHP sürümüyle uyumsuzluğundan kaynaklanır. Eski bir eklenti tarafından çağrılan bir fonksiyon, PHP'nin güncel bir sürümünde kaldırılmış olabilir; bu da anında ölümcül bir hataya yol açar.

İkinci sık görülen durum ise yarıda kalan bir güncellemedir: bir eklentinin otomatik güncellenmesi sırasında ağ kesintisi veya zaman aşımı yaşanması, dosyaların yarım yazılmış halde kalmasına neden olur. WordPress bazen bu durumu tespit eder ve takılı kalan bir bakım modunu etkinleştirir (kök dizindeki .maintenance dosyası).

Son olarak, PHP bellek sınırının (WP_MEMORY_LIMIT) aşılması da, özellikle aynı anda çok sayıda eklentinin aktif olduğu veya büyük veri içe aktarma işlemlerinin yapıldığı sitelerde, bu tür bir hataya yol açabilir.