跳到主要内容
万能墙开放平台
插件开发教程

定时任务

全部内容基于万能墙真实的插件平台(清单 + 钩子 + 接口 + 后台页 + 数据 + 定时任务),示例可直接复制运行。

注册

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 脚本)