Web ve Geliştirme

WordPress Cron Çalışmıyor? Zamanlanmış Görevleri ve Kaçırılan Yazıları Nasıl Düzeltirsiniz

WordPress Cron Not Working? How to Fix Scheduled Tasks and Missed Posts

WordPress zamanlanmış yazılar yayımlandığında sorun yaşıyor mu? WP-Cron sorunlarını nasıl teşhis edeceğinizi, zamanlanmış olayları nasıl inceleyeceğinizi, döngü hatalarını nasıl düzelteceğinizi ve güvenilir bir sunucu cron işini adım adım nasıl yapılandıracağınızı öğrenin.

WordPress Cron Çalışmıyor Mu? Zamanlanmış Görevleri ve Kaçırılan Yazıları Nasıl Düzeltirim

Bir WordPress makalesini 09:00'a programlıyorsunuz. Saat 09:30'da hala görünmüyor.

Veya WooCommerce e-postalarınız gecikiyor, zamanlanmış yedeklemeler asla başlamıyor veya bir eklenti arka plan görevlerinin geciktiğini bildiriyor olabilir.

Bu sorunların çoğu ortak bir özelliğe sahiptir: WP-Cron, WordPress'in yerleşik görev planlama sistemidir.

WP-Cron, barındırma sunucunuzun görev planlayıcısına erişim gerektirmeden çalıştığı için kullanışlıdır. Ancak geleneksel bir sistem cron görevi gibi, sürekli olarak arka planda çalışmaz.

Bu kılavuzda, WP-Cron'un nasıl çalıştığını, gecikmiş görevlerin nedenini nasıl tespit edeceğinizi ve gerektiğinde varsayılan tetikleme mekanizmasını güvenilir bir sunucu cron göreviyle nasıl değiştireceğinizi öğreneceksiniz.

Hem ortak barındırma hem de komut satırı erişimine sahip sunucuları kapsayacağız.

ratgerleştiriştiriz: WP-Cron aslında nasıl çalışır

Geleneksel bir Linux cron daemonsının web sitesi trafiğinden bağımsız olarak kendi programını kontrol eder.

WP-Cron farklı çalışır. WordPress, normal web sitesi aktivitesi sırasında zamanlanmış görevleri kontrol eder ve uygun olduğunda wp-cron.php'a bir istek başlatmaya çalışır.

Bu, zamanlanmış bir etkinliğin kesin zamanlanmış zamanda çalıştırılmasının garanti olmadığı anlamına gelir.

Örneğin, son ziyaretçisini saat 22:00'da alan bir web sitesi düşünün. 02:00'da yedekleme zamanlanmıştır, ancak kimse gece boyunca siteyi ziyaret etmez.

Yedekleme, WordPress'in programlama sistemini tetikleyen başka bir istek alana kadar başlamayabilir.

İki planlama yöntemi nasıl farklılık gösteriyor

Varsayılan WP-Cron: Ziyaretçi isteği → WordPress olayları kontrol eder → Gecikmiş görevler başlar. WordPress isteklerine bağlıdır.

Sunucu cron: Sunucu planlayıcı → Beş dakende bir çalışır → Gecikmiş görevler başlar. Ziyaretçi trafiğinden bağımsız olarak çalışır.

Bir sunucu cron görevi, WordPress'in zamanlanmış etkinlikleri depolama şeklini değiştirmez. Sadece onları kontrol etmenin ve çalıştırmanın daha öngörülebilir bir yolunu sağlar.

2. Bir şeyler değiştirmeden önce semptomları tanıyın

Her gecikmiş WordPress işlemi WP-Cron tarafından neden olmaz.

Önce gerçek semptomu tespit etmeye başlayın.

Belirti Olası açıklama
Zamanlanmış yazılar "Kaçırılan program" mesajı gösteriyor Cron tetikleyicisi gecikmiş veya başarısız olmuş
Zamanlanmış e-postalar geç geliyor Cron gecikmesi, kuyruk işleme veya posta teslimatı sorunu
Otomatik yedeklemeler asla başlamıyor Eksik etkinlik, cron hatası veya yedekleme eklenti hatası
WooCommerce işlemleri beklemeye devam ediyor Eylem Planlayıcı işleme sorunu
Site Sağlığı bir loopback hatası bildiriyor WordPress kendi URL'sini güvenilir bir şekilde isteyemiyor
Görevler yalnızca web sitesini ziyaret ettikten sonra çalışır Trafik bağımlı cron tetikleme

Önemli fark, asla başlamayan bir görev ile başlayan ancak başarısız olan bir görev arasındadır.

WP-Cron'u bir sunucu planlayıcıyla değiştirmek ilk sorunu çözebilir. Ancak bozuk bir eklentiyi, mevcut olmayan bir veritabanını veya başarısız olan bir e-posta hizmetini otomatik olarak düzelmez.

3. İlk önce WordPress Site Sağlığını kontrol edin

Yapılandırma dosyalarına dokanmadan önce WordPress yönetim arayüzünü açın.

  1. Araçlar → Site Sağlığı'na gidin.
  2. Durum sekmesini açın.
  3. Zamanlanmış etkinlikler veya loopback istekleriyle ilgili uyarıları arayın.
  4. Değişiklikler yapmadan önce tam mesajı kaydedin.

Loopback isteği, WordPress'in kendi web sitesine yaptığı bir istektir.

Bu istekler başarısız olursa, zamanlanmış görevler doğru şekilde tetiklenmeyebilir.

Ortak nedenler arasında yanlış web sitesi URL'si, DNS çözümleme sorunları, SSL sertifikası sorunları, HTTP kimlik doğrulaması, güvenlik duvarı kısıtlamaları veya eklentiler ve temalarla çakışmalar yer alır.

Örnek: Şifre ile korunan bir test sitesi

Örneğin, şu adreste bir WordPress test ortamı oluşturduğunuzu varsayalım:

https://staging.example.com

Test sitesi HTTP Basic Authentication gerektirir.

WordPress kendi wp-cron.php uç noktasını istemeye çalışır, ancak sunucu, isteğin kimlik doğrulanmadığı için HTTP 401 yanıtını döndürür.

Sorun, mutlaka zamanlanmış görev kendisi değildir. Görevi tetiklemesi gereken istek reddedilmiştir.

Bu durumda, herkese açık HTTP loopback yolunu atlayan bir sunucu tarafı CLI planlayıcıyı kullanabilir veya WordPress'in iç isteklerinin doğru şekilde çalışmasını sağlamak için ortamı yapılandırabilirsiniz.

Cron'un çalışmasını sağlamak için test sitesinin şifre korumasını kaldırmayın.

4. WP-CLI ile zamanlanmış görevleri kontrol edin

SSH erişiminiz ve WP-CLI kuruluysa, planlayıcıyı doğrudan kontrol edebilirsiniz.

Önce WordPress kurulum dizinine geçin.

cd /path/to/wordpress

Sonra zamanlanmış etkinlikleri listeleyin:

wp cron event list

Kancanın adı, bir sonraki zamanlanmış çalıştırma ve tekrara benzer bilgileri görece=$((.

Makine tarafından okunabilir bir çıktı için:

wp cron event list --fields=hook,next_run_gmt,recurrence --format=json

Dikkat etmeniz gerekenler nelerdir?

Bir sonraki çalıştırma zamanı geçmiş olan etkinliklere dikkat edin.

Gecikmiş bir etkinlik faydalı bir uyarı işaretidir, ancak tek bir gecikmiş etkinlik, tüm planlayıcının bozuk olduğu anlamına gelmez.

Birden fazla ilgili olmayan kancanın gecikmiş olup olmadığını kontrol edin. Eğer öyleyse, küresel tetikleme mekanizmasını inceleyin.

Illustration of the article's main concept

Yalnızca bir eklentinin etkinlikleri etkileniyorsa, önce o eklentiyi inceleyin.

Gecikmiş görevleri manuel olarak çalıştırın

Bir test ortamında veya üretimdeki sonuçları onayladıktan sonra şunu çalıştırın:

wp cron event run --due-now

Bu, WordPress'e şu anda gecikmiş olan etkinlikleri çalıştırmasını ister.

Dikkatli olun: Bu komut gerçek iş yapar. Zamanlanmış içeriği yayınlayabilir, mesajlar gönderebilir, yedeklemeler başlatabilir veya e-ticaret işlemlerini tetikleyebilir.

Bu, zararsız bir tanılama önizlemesi değildir.

Başarıyla tamamlanır ancak görevler daha sonra tekrar gecikmiş olursa, sorununuz, görev geri aramalarından ziyade otomatik tetikleme mekanizması olabilir.

5. Trafik bağımlı WP-Cron'u bir sunucu cron göreviyle değiştirin

Zamanlanmış görevlerin önemli olduğu bir üretim web sitesi için bir sunucu cron görevi genellikle daha iyi bir seçenektir.

Amaç basittir:

  • WordPress'in normal sayfa isteklerinde otomatik olarak WP-Cron'u başlatmaya çalışmasını durdurun.
  • Sunucudan, gelen olayları düzenli aralıklarla işleme yapmasını isteyin.

Adım 1: wp-config.php'yi düzenleyin

wp-config.php'nin bir yedeğini alın.

Şu satırdan önce aşağıdaki yapılandırmayı ekleyin, size düzenlemeyi durdurmanızı söyleyen satır:

define('DISABLE_WP_CRON', true);

Bu, WordPress'in varsayılan otomatik cron oluşturmayı devre dışı bırakmasını sağlar. WordPress tarafından depolanan zamanlanmış etkinlikleri silmez.

Adım 2: Barındırma sunucunuzda bir zamanlanmış görev oluşturun

Barındırma kontrol panelinizi açın ve cron görev planlayıcısını bulun.

Standart bir WordPress kurulumu için şuna benzer bir PHP CLI komutunu planlayabilirsiniz:

/usr/bin/php /home/account/public_html/wp-cron.php

Hem PHP çalıştırıcı yolunu hem de WordPress kurulum yolunu barındırıcınız tarafından sağlanan gerçek değerlerle değiştirin.

Komut, doğru PHP sürümünü çalıştırmalı ve WordPress dosyalarını okuma iznine sahip olmalıdır.

WP-CLI kuruluysa, başka bir seçenek şudur:

cd /home/account/public_html && /usr/local/bin/wp cron event run --due-now

Bu alternatif, WordPress etkinliklerini açıkça WP-CLI aracılığıyla işler.

Aynı şeyi yapan birden fazla bağımsız cron görevi yerine, belirli bir kurulum için tek bir planlama yöntemini kullanın.

Adım 3: Uygun bir aralık seçin

Tipik bir web sitesi için beş dakika makul bir başlangıç noktasıdır.

Çalıştırma aralığı Günde planlayıcı çağrıları Maksimum anket gecikmesi* Örnek crontab ifadesi
1 dakika 1.440 1 dakika * * * * *
5 dakika 288 5 dakika */5 * * * *
10 dakika 144 10 dakika */10 * * * *
15 dakika 96 15 dakika */15 * * * *
30 dakika 48 30 dakika */30 * * * *

*Bunu, işlevsel bir planlayıcı ve kısa süreli görevler varsayımında yapılır. Gerçek çalıştırma, sunucu yükü veya uzun süreli geri aramalar nedeniyle gecikebilir.

Örneğin, her beş dakikada bir:

*/5 * * * *

Bir dakikalık aralık, daha sık kontrol sağlar ancak her web sitesi için gerekli değildir.

Düşük trafikli bir blog için beş veya on dakika tamamen yeterli olabilir. Yoğun bir e-ticaret mağazası için, arka plan iş yüküne bağlı olarak daha sık işleme ihtiyacınız olabilir.

Adım 户口4: Sonucu test edin

Sunucu görevi yapılandırmadan sonra en az iki zamanlanmış aralık bekleyin.

Sonra etkinlik listesini tekrar kontrol edin:

wp cron event list

Önceden gecikmiş etkinliklerin işlendiğini onaylayın.

Barındırma cron günlüklerini de kontrol edin.

Ayrıca, gerçek bir iş operasyonunu da doğrulayın: Zamanlanmış bir test yazısı, zararsız bir bakım görevi veya sonuçları güvenli bir şekilde gözlemlenebilen başka bir işlem.

6. Barındırıcınız SSH erişimi sağlamıyorsa ne yapmalı?

Yine de birçok ortak barındırma planında bir sunucu cron görevi yapılandırabilirsiniz.

Bazı barındırma panoları, örneğin, bir zamanlanmış URL isteğini destekler:

https://example.com/wp-cron.php

Diğerleri, etkileşimli bir SSH terminali sağlamadan PHP komutu yürütmeyi sunar.

Destekleniyorsa, bir PHP CLI görevi tercih edin. Zamanlanmış bir HTTP isteği, yeniden yönlendirmeler, erişim kısıtlamaları, güvenlik kuralları veya ağ sorunlarından etkilenebilir.

Barındırma paneliniz yalnızca HTTP isteklerini destekliyorsa, uç noktanın erişilebilir olduğunu ve isteğin gerçekten de gecikmiş görevleri tetiklediğini onaylayın.

Bir HTTP 200 yanıtı almanın, her zamanlanmış geri aramanın başarıyla tamamlandığını kanıtladığını varsaymayın.

Technical workflow illustration

7. Güvenli bir test etkinliği oluşturun

Geliştiriciler için, mevcut eklentilerden bağımsız olarak planlama sisteminin çalıştığını doğrulamaya yardımcı olabilecek küçük bir test eklentisi vardır.

Şu dosyayı oluşturun:

wp-content/plugins/ceikay-cron-test/ceikay-cron-test.php

Şunu ekleyin:

<?php
/**
 * Plugin Name: CeiKay Cron Test
 * Description: Temporary diagnostic cron event.
 */

if (!defined('ABSPATH')) {
    exit;
}

add_action('ceikay_cron_test', function () {
    error_log(
        'CeiKay cron test executed at ' .
        gmdate('Y-m-d H:i:s') .
        ' UTC'
    );
});

register_activation_hook(__FILE__, function () {
    if (!wp_next_scheduled('ceikay_cron_test')) {
        wp_schedule_event(
            time() + 60,
            'hourly',
            'ceikay_cron_test'
        );
    }
});

register_deactivation_hook(__FILE__, function () {
    wp_clear_scheduled_hook('ceikay_cron_test');
});

Eklentiyi WordPress yönetim arayüzünden etkinleştirin.

Bu, saate bir kez yazan basit bir tanılama mesajını PHP hata günlüğüne yazan bir etkinlik kaydeder. E-posta göndermez, içeriği değiştirmez veya harici ağ istekleri yapmaz.

İlk etkinlik, aktivasyondan yaklaşık bir dakika sonra zamanlanır.

Aktivasyondan hemen sonra WP-CLI ile test etmek için:

wp cron event run ceikay_cron_test

PHP hata günlüğünde şu mesaja benzer bir mesaj arayın:

CeiKay cron test executed at 2026-11-18 07:30:00 UTC

Zaman damgası yalnızca bir örnektir.

Otomatik planlayıcıyı test etmeyi tercih ediyorsanız (geri aramayı manuel olarak çalıştırmak yerine), etkinliğin başlamasını bekleyin ve yapılandırılmış cron mekanizmasının onu işlemesine izin verin.

Test tamamlandığında, tanılama eklentisini devre dışı bırakın ve silin.

8. Sorun giderme: cron görevi çalışıyor ancak görevler hala başarısız oluyor

İşleyen bir cron tetikleyici, sistemin yalnızca bir parçasıdır.

Sunucu planlayıcınız başarıyla çalışır ancak WordPress işlemleri başarısız olmaya devam ediyorsa, aşağıdaki tanılama tablosunu kullanın.

Sorun Ne kontrol etmelisiniz Önerilen eylem
Zamanlanmış etkinlikler listelenmiyor Eklenti kancasını kaydetmemiş olabilir Eklenti aktivasyonunu ve planlama kodunu kontrol edin
Etkinlikler hala gecikmiş Sunucu görevi çalıştırılmıyor olabilir Cron günlüklerini, PHP yolunu ve izinleri kontrol edin
PHP fatal hatası Görev geri araması veya eklenti hatası PHP hata günlüklerini ve yığın izini inceleyin
HTTP 401 veya 403 Kimlik doğrulama veya güvenlik duvarı Loopback erişim kısıtlamalarını gözden geçirin
HTTP 500 Uygulama veya sunucu hatası PHP/sunucu günlüklerini inceleyin
Etkinlikler çalışır ancak e-postalar gelmez Posta taşıma sorunu SMTP veya e-posta teslimat günlüklerini kontrol edin
Çift çalıştırmalar Çift planlamalar veya çakışan süreçler Kancaları, argümanları ve kilitlemeyi inceleyin
WooCommerce işlemleri beklemeye devam ediyor Eylem Planlayıcı sırası Zamanlanmış işlemler arayüzünü ve bireysel hataları inceleyin

Gecikmiş etkinlikleri körlemesine silmeyin

Sıkışmış gibi görünen her etkinliği kaldırmaya cazip gelebilir.

Bunu yapmamaya çalışın.

Bir etkinlik, meşru bir zamanlanmış ödeme ilişkili işlemi, sipariş işleme görevini, e-posta teslimatını veya yedeklemeyi temsil edebilir.

Etkinliği silmek, altta yatan sorunu düzeltmeden zamanlanmış işi kaldırabilir.

WP-CLI, etkinlikleri silmek için komutlar sağlar, ancak bunlar yalnızca kanca tespit edildikten ve amacının anlaşılmasından sonra kullanılmalıdır.

9. Kendi eklentilerinizde çift zamanlanmış etkinliklerden kaçının

Bir WordPress eklentisi geliştiriyorsanız, ortak bir hata, aynı yinelenen etkinliği tekrar tekrar kaydetmektir.

Örneğin, bir görevi her sayfa yüklenmesinde, onun zaten var olup olmadığını kontrol etmeden planlayın.

Doğru yaklaşım, önce kontrol etmektir:

if (!wp_next_scheduled('myplugin_daily_cleanup')) {
    wp_schedule_event(
        time() + HOUR_IN_SECONDS,
        'daily',
        'myplugin_daily_cleanup'
    );
}

Sonra geri aramayı ayrı olarak kaydedin:

add_action('myplugin_daily_cleanup', function () {
    // Perform a small, bounded maintenance task.
});

Etkinlik argümanları kabul ediyorsa, planlama, kontrol ve temizleme sırasında tutarlı argümanları kullanın. WordPress, zamanlanmış etkinlikleri ayırt etmek için kancayı ve argümanları kullanır.

Ayrıca çalıştırma süresini de göz önünde bulundurun. Bir görevi, binlerce kaydı tek bir istekte işleme, PHP çalıştırma süresini veya belleği tüketebilir.

Büyük iş yükleri için verileri küçük gruplara bölün, işlemleri yeniden denemeye uygun hale getirin ve ilerlemeyi kaydedin.

10. Güvenilir bir WordPress planlayıcı için pratik bir kontrol listesi

Sorunun çözüldüğünü varsırmadan önce şu noktaları doğrulayın:

  • [ ] WordPress Site Sağlığı, açıklanamayan planlama veya loopback hataları göstermiyor.
  • [ ] Beklenen zamanlanmış kancalar mevcut.
  • [ ] Sunucu cron'u, amaçlanan aralıkta çalıştırılıyor.
  • [ ] DISABLE_WP_CRON, yalnızca alternatif bir tetikleyici hazır olduktan sonra yapılandırılır.
  • [ ] Cron görevi, doğru PHP çalıştırıcıyı ve WordPress yolunu kullanıyor.
  • [ ] Gerçek bir zamanlanmış görev başarıyla tamamlanıyor.
  • [ ] Bir görev başarısız olduğunda günlükler danışılabilir.
  • [ ] Hiçbir çift planlayıcı yapılandırması etkin değil.
  • [ ] Kritik işlemlerin kendi izleme veya başarısızlık uyarıları var.

Güvenilir bir planlayıcı, yalnızca çalışan bir planlayıcı değildir. Başarısızlıkları tanımlayabildiğiniz ve araştırabildiğiniz bir planlayıcıdır.

11. Son düşünceler: Ne zaman sunucu cron'u kullanmalısınız?

Zamanla arası olmayan, az sayıda ziyaretçili küçük bir kişisel blog için varsayılan WP-Cron tamamen yeterli olabilir.

Ancak web siteniz, zamanlanmış yayınlama, arka plan bakımı, e-ticaret işleme veya diğer yinelenen işlemlerden bağımlıysa, bir sunucu cron görevi düşünmeye değer.

Geliştirme, sunucu cron'un her WordPress eklentisini sihirli bir şekilde güvenilir hale getirdiği değildir. Bu, bir önemli belirsizliği ortadan kaldırır: gecikmiş etkinlikleri tetiklemek için gelen web sitesi isteklerine bağımlılık.

Önce gerçek hatayı teşhis edin, zamanlanmış etkinlikleri inceleyin ve yalnızca o zaman tetikleme mekanizmasını değiştirin.

Bu yaklaşım, neyin yanlış gittiğini bilmeden başka bir eklenti kurmaktan veya yapılandırma ayarlarını değiştirmekten daha güvenlidir.