# WordPress ve WooCommerce logları nerede bulunur ve nasıl okunur

> Bir WooCommerce mağazası, hatalarını kaynağına göre birkaç ayrı günlüğe yazar: WordPress'in çekirdeği, WooCommerce eklentisinin kendisi ve sunucu. Nereye bakılacağını bilmek, yanlış dosyada zaman kaybetmeyi önler.

- Source canonique : [https://allaux.fr/tr/guides/lire-logs-erreurs-woocommerce](https://allaux.fr/tr/guides/lire-logs-erreurs-woocommerce)
- Langue : TR
- Dernière mise à jour : 2026-09-30

## Bilinmesi gereken üç günlük

1. **wp-content/debug.log** — wp-config.php dosyasında WP_DEBUG_LOG etkinleştirildikten sonra WordPress, çekirdek, eklentiler ve tema tarafından üretilen tüm PHP hatalarını, uyarılarını ve bildirimlerini, ilgili dosya ve satır numarasıyla birlikte buraya yazar.
2. **WooCommerce > Durum > Günlükler** — WordPress yönetim panelinden erişilen bu ekran, kaynağına göre ayrılmış günlükleri listeler: ödeme, webhook, e-posta gönderimi, stok senkronizasyonu. Sipariş veya ödeme sorunlarında bakılması gereken ilk yerdir.
3. **Sunucu günlükleri** — Barındırma paneli veya SSH üzerinden erişilen bu günlükler, sunucu düzeyindeki PHP hatalarını (error_log) ve Apache ya da Nginx günlüklerini kaydeder; site WordPress yüklenmeden önce bile erişilemez durumdaysa faydalıdır.
4. **Tam saati belirleyin** — Çok kaynaklı her teşhiste olduğu gibi, olayın kesin saati, aynı hatayı birden fazla günlükte bulmayı ve birden çok belirtinin aynı nedene bağlı olup olmadığını doğrulamayı sağlar.
5. **Birden fazla eklenti hata yazıyorsa kaynağı ayırt edin** — Çok sayıda etkin eklentisi olan bir sitede debug.log, mevcut sorunla ilgisi olmayan gürültü içerebilir; eklentinin adı veya wp-content/plugins içindeki yolu genellikle hata satırının kendisinde görünür.

## WooCommerce neden kendi günlüklerine sahiptir

WooCommerce, bazı olayları debug.log'dan ayrı olarak kaydeder çünkü bunlar her zaman tam anlamıyla birer PHP hatası değildir: alınan ancak reddedilen bir ödeme webhook'u, bir ödeme geçidiyle sessizce başarısız olan bir senkronizasyon denemesi veya gönderilemeyen bir sipariş onay e-postası gibi. Bu olaylar yalnızca WooCommerce, Durum, Günlükler bölümünden görülebilir.

debug.log dosyası ise, dar anlamda bir PHP hatası veya uyarısı sayılan her şeyi yakalar: iyi bakımı yapılmayan bir eklenti tarafından çağrılan kullanımdan kaldırılmış bir fonksiyon, bir dizi beklenirken kullanılan boş (null) bir değer veya sayfanın yüklenmesini kesintiye uğratan ölümcül bir hata gibi. Kritik bir WordPress hatasıyla karşılaşıldığında en yararlı kaynak budur.

## wp-content/debug.log (extrait typique)

```
[24-Jul-2026 09:14:02 UTC] PHP Fatal error:  Uncaught Error: Call to undefined function some_removed_function() in /wp-content/plugins/exemple-extension/exemple.php:42
```

## Eklentinin adı hemen hemen her zaman görünür

> Hata mesajındaki dosya yolu genellikle wp-content/plugins/eklenti-adı veya wp-content/themes/tema-adı şeklindedir; bu da eklentileri tek tek devre dışı bırakmaya gerek kalmadan kaynağı doğrudan belirler.

## Önem düzeyi izlenecek yöntemi değiştirir

debug.log dosyasındaki her satır aynı aciliyetle ele alınmaz. PHP Fatal error düzeyindeki bir hata sayfanın çalışmasını keser ve genellikle beyaz ekranı veya kritik hata mesajını doğrudan açıklar. Bir PHP Warning veya PHP Deprecated ise genellikle sayfanın görüntülenmesini engellemez, ancak PHP veya WordPress'in bir sonraki sürüm yükseltmesinde uyumsuz hâle gelecek bir kodu işaret eder.

Aktif bir mağazada, o anki sorunla ilgisi olmayan yüzlerce bildirim veya uyarı satırı bulmak yaygındır. Önce ölümcül hatalara, ardından zaman damgası olayla tam olarak örtüşen uyarılara odaklanmak, gözlemlenen belirtiyle ilgisi olmayan mesajları düzeltmeye zaman harcamayı önler.

## FAQ

### Site çöktüğü hâlde debug.log neden boş?

Dosya, yalnızca WP_DEBUG_LOG etkinleştirildikten ve ilk hata oluştuktan sonra oluşturulur. Boş kalıyorsa hata muhtemelen WordPress yüklenmeden önce, örneğin bir sunucu sorunu veya geçersiz bir .htaccess nedeniyle oluşuyordur: bu durumda sunucu günlüklerine bakmak gerekir.

### debug.log dosyasını risksiz şekilde silebilir miyim?

Evet, bu dosya tamamen bilgilendirme amaçlıdır ve istediğiniz zaman silinebilir. WP_DEBUG_LOG etkin kaldığı sürece WordPress, bir sonraki hatada yeni bir dosya oluşturur.

### WooCommerce günlükleri üçüncü taraf ödeme eklentilerini de kapsıyor mu?

Büyük ölçüde evet; WooCommerce ödeme eklentilerinin çoğu yerleşik günlükleme sistemini (WC_Logger) kullanır, bu nedenle hataları WooCommerce > Durum > Günlükler bölümünde yerleşik günlüklerle aynı yerde görünür.

### WooCommerce > Durum > Günlükler'deki bir satırı hangi eklentinin yazdığı nasıl anlaşılır?

Her günlük dosyası, kaynağının adını (örneğin ödeme geçidinin adı) ve bir zaman damgasını taşır; bunlar günlükler ekranının üst kısmındaki açılır menüde görülebilir.