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
- Blok dizininizde
cron.phpoluşturursunuz - Adlandırılmış işlerden oluşan ilişkisel bir dizi döndürür
- Her sayfa yüklemesinde Blockstudio, işlerin zamanlanıp zamanlanmadığını kontrol eder
- Eksik zamanlamalar
wp_schedule_event()ile kaydedilir - WordPress Cron, geri çağırımları tanımlanan aralıkta çalıştırır
- 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
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:
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
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:
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;
});
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:
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:
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:
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:
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:
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:
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:
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:
*/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:
define('DISABLE_WP_CRON', true);
Zamanlanmış etkinlikleri kontrol etmek için WP-CLI kullanın:
wp cron event list | grep blockstudio