Cron
Sistemul cron vă permite să definiți sarcini programate care rulează în fundal la intervale recurente. Adăugați un fișier cron.php în directorul blocului, iar Blockstudio înregistrează sarcinile cu WordPress Cron și le gestionează ciclul de viață. Instalările ca plugin independent își curăță sarcinile la dezactivare. Instalările Composer incluse într-o temă sau într-un alt plugin necesită curățare din partea gazdei sau wp bs teardown înainte ca gazda să fie dezactivată, schimbată sau eliminată.
Aceasta este ultima componentă a modelului de bloc full-stack: blocul dvs. poate avea un UI (index.twig), logică pe server (rpc.php), date persistente (db.php) și acum procesare în fundal (cron.php).
Cum funcționează
- Creați
cron.phpîn directorul blocului - Acesta returnează un tablou asociativ de sarcini cu nume
- La fiecare încărcare a paginii, Blockstudio verifică dacă sarcinile sunt programate
- Programările lipsă sunt înregistrate cu
wp_schedule_event() - WordPress Cron declanșează funcțiile de callback la intervalul definit
- La dezactivarea unui plugin Blockstudio independent, toate evenimentele Blockstudio cron sunt anulate; instalările incluse folosesc căile de curățare de mai jos
blocks/my-block/
├── block.json
├── index.twig
├── rpc.php ← custom endpoints
├── db.php ← data model
├── cron.php ← background tasks
└── style.css
Definirea sarcinilor
Returnați un tablou asociativ de sarcini. Fiecare sarcină poate fi o funcție callback directă (implicită la daily) sau un tablou cu schedule și callback:
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());
},
];
Definiții native pentru PHP
cron.php poate returna și un obiect cu metode atribuite. Astfel obțineți o interfață mai curată, nativă PHP, păstrând intactă sintaxa existentă a tabloului.
<?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
}
};
În mod implicit, numele metodelor sunt normalizate la litere mici și format snake case, astfel încât cleanupOldEntries() devine cleanup_old_entries. Folosiți name: când doriți un nume explicit pentru sarcină.
Programări
Integrate
WordPress oferă implicit următoarele programări:
| Programare | Interval |
|---|---|
hourly |
La fiecare oră |
twicedaily |
La fiecare 12 ore |
daily |
La fiecare 24 de ore |
weekly |
La fiecare 7 zile |
Intervale personalizate
Înregistrați intervale personalizate prin filtrul WordPress cron_schedules, apoi faceți referire la acestea în cron.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;
});
return [
'check_external_api' => [
'schedule' => 'every_five_minutes',
'callback' => function () { /* ... */ },
],
];
Tipare uzuale
Întreținerea datelor
Curățați înregistrările vechi, expirați perioadele de probă și arhivați intrările inactive:
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']);
}
}
},
],
];
Sincronizare API externă
Preluați periodic date de la servicii terțe:
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);
}
}
},
],
];
Notificări și rezumate
Trimiteți rapoarte periodice sau e-mailuri de notificare:
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");
},
],
];
Dezactivare
Când Blockstudio este instalat ca plugin independent, dezactivarea pluginului anulează automat toate evenimentele Blockstudio cron.
O instalare Composer inclusă într-o temă sau într-un alt plugin nu are propriul hook de dezactivare. Dezactivarea pluginului gazdă, trecerea la o altă temă gazdă sau eliminarea codului inclus lasă evenimentele programate dacă gazda nu efectuează o curățare. Rulați comanda de dezinstalare înainte de oricare dintre aceste acțiuni:
wp bs teardown
Anulează programarea fiecărui eveniment Blockstudio cron și elimină starea statică de prerandare pe care o deține instalarea. Pentru detalii, consultați CLIdetaliile.
Comanda este disponibilă numai cât timp Blockstudio este încă încărcat. În schimb, un plugin gazdă poate înregistra curățarea din fișierul principal al pluginului:
register_deactivation_hook(__FILE__, function () {
if (class_exists(\Blockstudio\Cron::class)) {
\Blockstudio\Cron::unschedule_all();
}
});
O temă care include codul poate folosi același callback la switch_theme. Înregistrați-l cât timp tema veche este încărcată, nu în hook-ul after_switch_theme al temei următoare:
add_action('switch_theme', function () {
if (class_exists(\Blockstudio\Cron::class)) {
\Blockstudio\Cron::unschedule_all();
}
});
Cron::unschedule_all() elimină toate evenimentele Blockstudio cron, nu doar sarcinile unui singur bloc sau ale unei singure gazde. Aceste hook-uri nu elimină starea de prerandare statică; folosiți wp bs teardown când retrageți întreaga instalare. Fără curățare, evenimentele recurente rămân în WordPress și se pot relua dacă codul blocului este instalat din nou.
Filtrare
Modificați sau dezactivați programatic sarcinile:
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;
});
Depanare
WordPress Cron este declanșat de vizitele pe pagină, nu de un planificator la nivel de sistem.
Pe site-urile cu trafic redus, sarcinile pot să nu se declanșeze exact conform programului. Pentru o temporizare fiabilă,
configurați un cron real care accesează wp-cron.php:
*/5 * * * * curl -s https://yoursite.com/wp-cron.php > /dev/null 2>&1
Apoi dezactivați declanșatorul cron integrat în WordPress din wp-config.php:
define('DISABLE_WP_CRON', true);
Pentru a verifica evenimentele programate, folosiți WP-CLI:
wp cron event list | grep blockstudio