Treci la conținut

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ă

  1. Creați cron.php în directorul blocului
  2. Acesta returnează un tablou asociativ de sarcini cu nume
  3. La fiecare încărcare a paginii, Blockstudio verifică dacă sarcinile sunt programate
  4. Programările lipsă sunt înregistrate cu wp_schedule_event()
  5. WordPress Cron declanșează funcțiile de callback la intervalul definit
  6. La dezactivarea unui plugin Blockstudio independent, toate evenimentele Blockstudio cron sunt anulate; instalările incluse folosesc căile de curățare de mai jos
Cod
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:

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());
    },
];

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
<?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:

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 () { /* ... */ },
    ],
];

Tipare uzuale

Întreținerea datelor

Curățați înregistrările vechi, expirați perioadele de probă și arhivați intrările inactive:

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']);
                }
            }
        },
    ],
];

Sincronizare API externă

Preluați periodic date de la servicii terțe:

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);
                }
            }
        },
    ],
];

Notificări și rezumate

Trimiteți rapoarte periodice sau e-mailuri de notificare:

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");
        },
    ],
];

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:

Shell
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:

PHP
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:

PHP
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:

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;
});

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:

Shell
*/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:

PHP
define('DISABLE_WP_CRON', true);

Pentru a verifica evenimentele programate, folosiți WP-CLI:

Shell
wp cron event list | grep blockstudio