Cron
cron 시스템을 사용하면 백그라운드에서 반복 간격으로 실행되는 예약 작업을 정의할 수 있습니다. 블록 디렉터리에 cron.php 파일을 추가하면 Blockstudio가 WordPress Cron에 작업을 등록하고 수명 주기를 관리합니다. 독립형 플러그인은 비활성화될 때 해당 작업을 정리합니다. 테마나 다른 플러그인에 포함된 Composer 설치는 호스트가 비활성화되거나 전환되거나 제거되기 전에 호스트 측에서 정리하거나 wp bs teardown해야 합니다.
이는 풀스택 블록 패턴의 마지막 구성 요소입니다. 블록에 UI(index.twig), 서버 로직(rpc.php), 영구 데이터(db.php), 그리고 이제 백그라운드 처리(cron.php)를 둘 수 있습니다.
작동 방식
- 블록 디렉터리에
cron.php를 만듭니다. - 이름이 지정된 작업의 연관 배열을 반환합니다.
- 페이지가 로드될 때마다 Blockstudio가 작업이 예약되어 있는지 확인합니다.
- 예약되지 않은 작업은
wp_schedule_event()에 등록됩니다. - WordPress Cron가 정의된 간격에 따라 콜백을 실행합니다.
- 독립형 Blockstudio 플러그인을 비활성화하면 모든 Blockstudio cron 이벤트의 예약이 취소됩니다. 포함된 설치는 아래의 정리 경로를 사용합니다.
blocks/my-block/
├── block.json
├── index.twig
├── rpc.php ← custom endpoints
├── db.php ← data model
├── cron.php ← background tasks
└── style.css
작업 정의
작업의 연관 배열을 반환합니다. 각 작업은 직접 콜백(기본값은 daily)이거나 schedule 및 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());
},
];
PHP 네이티브 정의
cron.php은 속성 메서드가 포함된 객체도 반환할 수 있습니다. 기존 배열 구문을 유지하면서 더 간결한 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
}
};
기본적으로 메서드 이름은 소문자 스네이크 케이스로 정규화되므로 cleanupOldEntries()은 cleanup_old_entries이 됩니다. 작업 이름을 직접 지정하려면 name:를 사용하세요.
예약 일정
기본 제공
WordPress은 기본으로 다음 예약 일정을 제공합니다.
| 예약 일정 | 간격 |
|---|---|
hourly |
매시간 |
twicedaily |
12시간마다 |
daily |
24시간마다 |
weekly |
7일마다 |
사용자 지정 간격
WordPress cron_schedules 필터로 사용자 지정 간격을 등록한 다음 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 () { /* ... */ },
],
];
일반적인 패턴
데이터 유지 관리
오래된 레코드 정리, 평가판 만료, 비활성 항목 보관:
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']);
}
}
},
],
];
외부 API 동기화
일정에 따라 타사 서비스에서 데이터를 가져옵니다.
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);
}
}
},
],
];
알림 및 요약
정기 보고서 또는 알림 이메일을 보냅니다.
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");
},
],
];
비활성화
Blockstudio를 독립 플러그인으로 설치한 경우, 해당 플러그인을 비활성화하면 모든 Blockstudio cron 이벤트의 예약이 자동으로 취소됩니다.
테마나 다른 플러그인에 포함된 Composer 설치에는 자체 비활성화 훅이 없습니다. 호스트 플러그인을 비활성화하거나 호스트 테마에서 전환하거나 포함된 코드를 제거하면 호스트가 정리하지 않는 한 이벤트 예약이 유지됩니다. 다음 작업을 수행하기 전에 해제 명령을 실행하세요:
wp bs teardown
이 명령은 모든 Blockstudio cron 이벤트의 예약을 취소하고 설치에서 소유한 정적 사전 렌더링 상태를 제거합니다. 자세한 내용은 CLI자세한 내용을 참조하세요.
Blockstudio가 아직 로드되어 있을 때만 이 명령을 사용할 수 있습니다. 대신 호스트 플러그인의 메인 플러그인 파일에서 정리 작업을 등록할 수 있습니다:
register_deactivation_hook(__FILE__, function () {
if (class_exists(\Blockstudio\Cron::class)) {
\Blockstudio\Cron::unschedule_all();
}
});
번들 테마에서는 switch_theme에 동일한 콜백을 사용할 수 있습니다. 이전 테마가 로드되어 있을 때 등록하세요. 다음 테마의 after_switch_theme 훅에서 등록하면 안 됩니다:
add_action('switch_theme', function () {
if (class_exists(\Blockstudio\Cron::class)) {
\Blockstudio\Cron::unschedule_all();
}
});
Cron::unschedule_all()는 한 블록이나 호스트의 작업만이 아니라 모든 Blockstudio cron 이벤트를 제거합니다. 이 훅은 정적 사전 렌더링 상태를 제거하지 않습니다. 전체 설치를 폐기할 때는 wp bs teardown를 사용하세요. 정리하지 않으면 반복 이벤트가 WordPress에 남아 있다가 해당 블록 코드를 다시 설치하면 재개될 수 있습니다.
필터
작업을 프로그래밍 방식으로 수정하거나 비활성화합니다:
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;
});
디버깅
WordPress Cron은 시스템 수준의 스케줄러가 아니라 페이지 방문을 통해 실행됩니다.
트래픽이 적은 사이트에서는 작업이 정확한 일정에 맞춰 실행되지 않을 수 있습니다. 정확한 실행 시간을 원한다면
wp-cron.php에 요청을 보내는 실제 시스템 cron을 설정하세요:
*/5 * * * * curl -s https://yoursite.com/wp-cron.php > /dev/null 2>&1
그런 다음 wp-config.php에서 WordPress의 기본 제공 cron 트리거를 비활성화합니다:
define('DISABLE_WP_CRON', true);
예약된 이벤트를 확인하려면 WP-CLI을 사용하세요:
wp cron event list | grep blockstudio