Rehber Xenforo Hata Ayıklama Rehberi: Server Error Logs, Debug Mode ve Yaygın Sorunların Çözümü

[XFSkins]

XenForo Hata Ayıklama Rehberi
Server error logs, debug mode ve yaygın sorunların çözümü​

Bu rehber XenForo 2.3.10 sürümüne göre hazırlanmıştır. XenForo’da hata çözmenin en sağlıklı yolu, rastgele dosya düzenlemek değil, hatayı doğru yerden okumaktır.

1. İlk Bakılacak Yer: Server Error Log​

Admin panelinde şu yolu izleyebilirsiniz:

Admin Paneli > Araçlar > Server error log

Türkçeleştirilmiş kurulumlarda bu alan Sunucu hata kayıtları gibi görünebilir.

Bu ekranda genellikle şunları görürsünüz:

• Hata mesajı.
• Hatanın oluştuğu dosya ve satır.
• Stack trace.
• Kullanıcı ve istek bilgisi.
• Tarih ve saat.

2. Debug Mode Nedir?​

Debug mode, geliştirme ve hata ayıklama sırasında ek bilgi gösterir. Canlı sitede açık bırakılmamalıdır.

$config['debug'] = true;

Bu ayar src/config.php içinde kullanılır.

Dikkat: Debug mode canlı sitede hassas bilgi gösterebilir. Sadece local veya test ortamında kullanın.

3. Development Mode Nedir?​

Development mode; add-on, template modification, route, phrase ve benzeri geliştirme ekranlarının daha kapsamlı kullanılmasını sağlar.

$config['development']['enabled'] = true;

Bu ayar da canlı sitede açık bırakılmamalıdır.

4. Eklentileri Geçici Olarak Devre Dışı Bırakma​

Bir hata eklenti kaynaklıysa, ilgili eklentiyi admin panelinden kapatmak çoğu zaman yeterlidir.

Acil durumda config üzerinden listener’ları kapatma seçeneği de vardır:

$config['enableListeners'] = false;

Bu kalıcı çözüm değildir. Sadece admin paneline erişmek veya sorunlu eklentiyi devre dışı bırakmak için geçici olarak kullanılmalıdır.

5. Beyaz Sayfa veya 500 Hatası​

Beyaz sayfa genellikle PHP fatal error, syntax error veya template compilation hatası anlamına gelir.

Kontrol sırası:

1. Server error log ekranını kontrol edin.
2. PHP error log dosyasını kontrol edin.
3. Son düzenlenen eklenti veya şablonu geri alın.
4. Son kurulan eklentiyi devre dışı bırakın.
5. Gerekirse listener’ları geçici kapatın.

6. Template Hataları​

Şablon hatalarında genellikle eksik kapanış etiketi, hatalı ifade veya yanlış değişken kullanımı olur.

Yaygın örnekler:

• </xf:if> kapatmayı unutmak.
• </xf:foreach> kapatmayı unutmak.
• Var olmayan değişkene erişmek.
• Template syntax içine PHP yazmaya çalışmak.
• Regex ile yanlış template modification uygulamak.

7. Tarayıcı Konsolu​

Görsel veya JavaScript sorunlarında tarayıcı konsolunu mutlaka kontrol edin.

• 404 veren CSS/JS dosyaları.
• JavaScript hataları.
• CORS veya mixed content uyarıları.
• Mobil görünümde taşan alanlar.

8. Dosya Sağlığı Kontrolü​

XenForo’da dosyaların eksik veya değişmiş olup olmadığını kontrol etmek için file health check kullanılabilir.

Admin panelinde:

Admin Paneli > Araçlar > File health check

Türkçe kurulumlarda Dosya sağlık kontrolü gibi görünebilir.

9. Sorun Çözme Akışı​

1. Hata mesajını tam okuyun.
2. Hatanın hangi add-on veya dosyadan geldiğini belirleyin.
3. Son yapılan değişikliği düşünün.
4. Local/test ortamında aynı hatayı üretmeye çalışın.
5. Gerekiyorsa eklentiyi geçici kapatın.
6. Kalıcı çözümü küçük bir değişiklikle uygulayın.
7. Tekrar server error log kontrolü yapın.

10. Sık Yapılan Hatalar​

• Hata mesajını okumadan rastgele dosya düzenlemek.
• Canlı sitede debug mode’u açık bırakmak.
• Eklentiyi kaldırmadan dosyalarını silmek.
• Template syntax hatasını CSS sorunu sanmak.
• Sunucu hata loglarını temizleyip tekrar kontrol etmemek.

---

Özet: XenForo’da hata ayıklama düzenli bir süreçtir: logu oku, kaynağı bul, küçük değişiklik yap, tekrar test et. Rastgele müdahale çoğu zaman sorunu büyütür.​