注册
php
registerPluginCron('my_plugin', 'sync_daily', 3600, function ($ctx) {
// 每小时跑一次;$ctx 里同样有 db
$n = (int)$ctx['db']->query('SELECT COUNT(*) FROM posts')->fetchColumn();
pluginLog('my_plugin', 'info', "巡检:当前帖子 {$n} 篇");
});| 参数 | 说明 |
| --- | --- |
| $slug | 插件标识 |
| $key | 任务名(同一插件内唯一,字母数字下划线短横线) |
| $interval | 间隔秒数,最小 60 |
| $cb | 回调,接收 $ctx(含 db) |
调度方式
- 定时任务随任意 API 请求顺带触发(无外部依赖、无需配置 crontab);
- 每次只跑「距上次执行已超过 interval」的任务,最后执行时间记在插件设置里(
cron_<key>); - 单次执行异常会记日志并计入故障;连续失败触发熔断后任务会暂停,可在后台「清除熔断」恢复;
- 页面渲染路径不会被阻塞:任务只在接口请求时执行,且失败不抛给用户。
适合放什么
✅ 数据汇总、清理过期记录、批量抓取、发提醒
❌ 需要秒级精度的任务、需要长连接常驻的任务(这类请用系统 cron 调一个自己的 CLI 脚本)