Projeler ve ajans desteği için müsait · Hızlı yanıt, işi yapan kişiden

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.

Sorunumu anlatayım Mesaj gönderin

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

Ö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.

Sıkça sorulan sorular

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.

İhtiyacınızı bir dakikada anlatın

Size bir anket daha değil, doğrudan bir tahmin sunabilmem için birkaç hedefli soru.

impact
message
declencheur
debug (facultatif)
acces (facultatif)
Size dönebilmem için en az bir e-posta veya telefon numarası belirtin.

Size dönebilmem için en az bir e-posta veya telefon numarası belirtin.