İçeriğe geç

Cron

cron sistemi, arka planda yinelenen aralıklarla çalışan zamanlanmış görevler tanımlamanızı sağlar. Blok dizininize bir cron.php dosyası ekleyin; Blockstudio işleri WordPress Cron ile kaydeder ve yaşam döngülerini yönetir. Bağımsız eklenti kurulumlarında eklenti devre dışı bırakılırken işler temizlenir. Bir temaya veya başka bir eklentiye dahil edilmiş Composer kurulumlarında ise ana bileşen devre dışı bırakılmadan, değiştirilmeden veya kaldırılmadan önce ana bileşen tarafında temizlik yapılması ya da wp bs teardown çalıştırılması gerekir.

Bu, tam yığın blok modelinin son parçasıdır: bloğunuzda bir UI (index.twig), sunucu mantığı (rpc.php), kalıcı veriler (db.php) ve artık arka plan işlemleri (cron.php) bulunabilir.

Nasıl çalışır

  1. Blok dizininizde cron.php oluşturursunuz
  2. Adlandırılmış işlerden oluşan ilişkisel bir dizi döndürür
  3. Her sayfa yüklemesinde Blockstudio, işlerin zamanlanıp zamanlanmadığını kontrol eder
  4. Eksik zamanlamalar wp_schedule_event() ile kaydedilir
  5. WordPress Cron, geri çağırımları tanımlanan aralıkta çalıştırır
  6. Bağımsız bir Blockstudio eklentisi devre dışı bırakıldığında tüm Blockstudio cron olaylarının zamanlaması kaldırılır; dahil edilmiş kurulumlarda aşağıdaki temizlik yolları kullanılır
Kod
blocks/my-block/
├── block.json
├── index.twig
├── rpc.php       ← custom endpoints
├── db.php        ← data model
├── cron.php      ← background tasks
└── style.css

Görevleri Tanımlama

Görevlerden oluşan ilişkisel bir dizi döndürün. Her görev doğrudan bir geri çağırım (varsayılanı daily) veya schedule ve callback içeren bir dizi olabilir:

PHP
return [
    // Expanded format with custom schedule
    'cleanup' => [
        'schedule' => 'hourly',
        'callback' => function () {
            // runs every hour
        },
    ],

    // Shorthand: just a callback, defaults to daily
    'heartbeat' => function () {
        update_option('my_block_last_heartbeat', time());
    },
];

PHP yerel tanımları

cron.php, öznitelik taşıyan yöntemlere sahip bir nesne de döndürebilir. Bu, mevcut dizi söz dizimini korurken daha sade, PHP yerel bir arayüz sağlar.

PHP
<?php
use Blockstudio\Attributes\Cron;
use Blockstudio\Cron\Schedule;

return new class {
    #[Cron(schedule: Schedule::Hourly)]
    public function heartbeat(): void {
        update_option('my_block_last_heartbeat', time());
    }

    #[Cron]
    public function cleanupOldEntries(): void {
        // defaults to daily
    }
};

Yöntem adları varsayılan olarak küçük harfli snake case biçimine dönüştürülür; bu nedenle cleanupOldEntries(), cleanup_old_entries olur. Açık bir görev adı istediğinizde name: kullanın.

Zamanlamalar

Yerleşik

WordPress, kutudan çıktığı gibi şu zamanlamaları sunar:

Zamanlama Aralık
hourly Her saat
twicedaily 12 saatte bir
daily 24 saatte bir
weekly 7 günde bir

Özel Aralıklar

WordPress cron_schedules filtresi üzerinden özel aralıklar kaydedin, ardından cron.php içinde bunlara başvurun:

PHP
add_filter('cron_schedules', function ($schedules) {
    $schedules['every_five_minutes'] = [
        'interval' => 300,
        'display'  => 'Every 5 Minutes',
    ];
    $schedules['every_fifteen_minutes'] = [
        'interval' => 900,
        'display'  => 'Every 15 Minutes',
    ];
    return $schedules;
});
PHP
return [
    'check_external_api' => [
        'schedule' => 'every_five_minutes',
        'callback' => function () { /* ... */ },
    ],
];

Yaygın Örüntüler

Veri Bakımı

Eski kayıtları temizleyin, deneme sürelerini sona erdirin, etkin olmayan girdileri arşivleyin:

PHP
use Blockstudio\Db;

return [
    'expire_trials' => [
        'schedule' => 'daily',
        'callback' => function () {
            $db     = Db::get('my-theme/app', 'subscribers');
            $trials = $db->list(['plan' => 'trial']);

            foreach ($trials as $trial) {
                if (strtotime($trial['created_at']) < strtotime('-14 days')) {
                    $db->update((int) $trial['id'], ['plan' => 'expired']);
                }
            }
        },
    ],
    'purge_old_logs' => [
        'schedule' => 'weekly',
        'callback' => function () {
            $db   = Db::get('my-theme/app', 'activity_log');
            $logs = $db->list();

            foreach ($logs as $log) {
                if (strtotime($log['created_at']) < strtotime('-90 days')) {
                    $db->delete((int) $log['id']);
                }
            }
        },
    ],
];

Harici API Senkronizasyonu

Üçüncü taraf hizmetlerden belirli aralıklarla veri alın:

PHP
return [
    'sync_products' => [
        'schedule' => 'hourly',
        'callback' => function () {
            $response = wp_remote_get('https://api.example.com/products');

            if (is_wp_error($response)) {
                return;
            }

            $products = json_decode(wp_remote_retrieve_body($response), true);
            $db       = \Blockstudio\Db::get('my-theme/shop', 'products');

            foreach ($products as $product) {
                $existing = $db->list(['external_id' => $product['id']]);

                if (empty($existing)) {
                    $db->create($product);
                } else {
                    $db->update((int) $existing[0]['id'], $product);
                }
            }
        },
    ],
];

Bildirimler ve Özetler

Düzenli raporlar veya bildirim e-postaları gönderin:

PHP
use Blockstudio\Db;

return [
    'weekly_digest' => [
        'schedule' => 'weekly',
        'callback' => function () {
            $db   = Db::get('my-theme/app', 'subscribers');
            $new  = count($db->list(['status' => 'active']));
            $admin = get_option('admin_email');

            wp_mail($admin, 'Weekly Digest', "Active subscribers: $new");
        },
    ],
];

Devre Dışı Bırakma

Blockstudio kendi başına bir eklenti olarak kurulduğunda, eklentiyi devre dışı bırakmak tüm Blockstudio cron olaylarının zamanlamasını otomatik olarak kaldırır.

Bir tema veya başka bir eklenti içindeki Composer kurulumunun kendine ait bir devre dışı bırakma kancası yoktur. Ana eklentiyi devre dışı bırakmak, ana temayı değiştirmek veya dahil edilmiş kodu kaldırmak, ana bileşen temizlik yapmadığı sürece olayların zamanlanmış olarak kalmasına neden olur. Aşağıdakilerden herhangi birini yapmadan önce temizleme komutunu çalıştırın:

Kabuk
wp bs teardown

Bu komut, tüm Blockstudio cron etkinliklerinin zamanlamasını kaldırır ve kurulumun sahibi olduğu statik önceden oluşturma durumunu siler. Ayrıntılar için CLI bölümüne bakın.

Komut yalnızca Blockstudio hâlâ yüklenmişken kullanılabilir. Ana eklenti bunun yerine kendi ana eklenti dosyasından temizlik kaydı oluşturabilir:

PHP
register_deactivation_hook(__FILE__, function () {
    if (class_exists(\Blockstudio\Cron::class)) {
        \Blockstudio\Cron::unschedule_all();
    }
});

Birleştirme yapan tema aynı geri çağırımı switch_theme üzerinde kullanabilir. Eski tema yüklenmişken kaydedin; sonraki temanın after_switch_theme kancasına kaydetmeyin:

PHP
add_action('switch_theme', function () {
    if (class_exists(\Blockstudio\Cron::class)) {
        \Blockstudio\Cron::unschedule_all();
    }
});

Cron::unschedule_all(), yalnızca bir blok veya ana bileşene ait işleri değil, tüm Blockstudio cron olaylarını kaldırır. Bu kancalar statik önceden oluşturulmuş durumu kaldırmaz; kurulumun tamamını devreden çıkarırken wp bs teardown kullanın. Temizlik yapılmazsa yinelenen olaylar WordPress içinde kalır ve blok kodu yeniden kurulursa tekrar çalışabilir.

Filtre

Görevleri programlı olarak değiştirin veya devre dışı bırakın:

PHP
add_filter('blockstudio/cron', function (array $jobs): array {
    // Disable a specific job
    unset($jobs['my-theme/app']['cleanup']);

    // Change a schedule
    if (isset($jobs['my-theme/app']['sync'])) {
        $jobs['my-theme/app']['sync']['schedule'] = 'twicedaily';
    }

    return $jobs;
});

Hata ayıklama

WordPress Cron, sistem düzeyindeki bir zamanlayıcı tarafından değil, sayfa ziyaretleriyle tetiklenir. Düşük trafikli sitelerde işler tam zamanında çalışmayabilir. Güvenilir zamanlama için wp-cron.php adresine istek gönderen gerçek bir sistem cron kurun:

Kabuk
*/5 * * * * curl -s https://yoursite.com/wp-cron.php > /dev/null 2>&1

Ardından wp-config.php içinde WordPress’ın yerleşik cron tetikleyicisini devre dışı bırakın:

PHP
define('DISABLE_WP_CRON', true);

Zamanlanmış etkinlikleri kontrol etmek için WP-CLI kullanın:

Kabuk
wp cron event list | grep blockstudio