PHPackages fly-cms/webman-crontab - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. fly-cms/webman-crontab ActiveLibrary fly-cms/webman-crontab ====================== Webman plugin fly-cms/webman-crontab v1.0.8(3y ago)12921[1 issues](https://github.com/settime/webman-crontab/issues)MITPHPPHP >=7.0 Since Mar 15Pushed 3y ago1 watchersCompare [ Source](https://github.com/settime/webman-crontab)[ Packagist](https://packagist.org/packages/fly-cms/webman-crontab)[ RSS](/packages/fly-cms-webman-crontab/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (8)Dependencies (2)Versions (9)Used By (0) workerman/crontab实现类似宝塔的任务管理 ============================ [](#workermancrontab实现类似宝塔的任务管理) 概述 -- [](#概述) 基于 **webman** + **workerman/crontab** 的定时任务组件 本组件代码参考 **webman crontab任务管理组件(多类型)** 重构出来的。 注意事项 ---- [](#注意事项) ***仅支持linux，仅支持linux，仅支持linux。*** ***秒级任务不要小于5秒，每个进程计时器会有差异，将会导致任务在同一秒执行不同次数的任务*** ***秒级任务必须是60的因数，经过观察发现workerman/crontab处理秒级任务，每分钟后会直接重置任务时间从头开始计算时间*** 安装 ``` composer require fly-cms/webman-crontab ``` 创建数据表 ----- [](#创建数据表) 创建任务数据表。 ``` CREATE TABLE IF NOT EXISTS `cms_crontab` ( `id` int(11) UNSIGNED NOT NULL AUTO_INCREMENT, `title` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '任务标题', `type` tinyint(1) NOT NULL DEFAULT 1 COMMENT '任务类型 (1 url, 2 eval 3 shell)', `task_cycle` tinyint(1) NOT NULL DEFAULT 1 COMMENT '任务周期', `cycle_rule` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '任务周期规则', `rule` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '任务表达式', `target` text COMMENT '调用任务字符串', `running_times` int(11) NOT NULL DEFAULT '0' COMMENT '已运行次数', `last_running_time` int(11) NOT NULL DEFAULT '0' COMMENT '上次运行时间', `status` tinyint(4) NOT NULL DEFAULT 0 COMMENT '任务状态状态[0:禁用;1启用]', `create_time` int(11) NOT NULL DEFAULT 0 COMMENT '创建时间', `delete_time` int(11) NOT NULL DEFAULT 0 COMMENT '软删除时间', `singleton` tinyint(1) NOT NULL DEFAULT 1 COMMENT '是否单次执行 (0 是 1 不是)', PRIMARY KEY (`id`) USING BTREE, INDEX `title`(`title`) USING BTREE, INDEX `status`(`status`) USING BTREE ) ENGINE = InnoDB AUTO_INCREMENT = 1 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = '定时器任务表' ROW_FORMAT = DYNAMIC ``` 创建日志数据表 ``` CREATE TABLE IF NOT EXISTS `cms_crontab_log` ( `id` int(11) UNSIGNED NOT NULL AUTO_INCREMENT, `crontab_id` bigint UNSIGNED NOT NULL COMMENT '任务id', `target` varchar(255) COMMENT '任务调用目标字符串', `log` text COMMENT '任务执行日志', `return_code` tinyint(1) NOT NULL DEFAULT 0 COMMENT '执行返回状态[0成功; 1失败]', `running_time` varchar(10) NOT NULL COMMENT '执行所用时间', `create_time` int(11) NOT NULL DEFAULT 0 COMMENT '创建时间', PRIMARY KEY (`id`) USING BTREE, INDEX `create_time`(`create_time`) USING BTREE, INDEX `crontab_id`(`crontab_id`) USING BTREE ) ENGINE = InnoDB AUTO_INCREMENT = 1 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = '定时器任务执行日志表' ROW_FORMAT = DYNAMIC ``` 修改配置信息 ------ [](#修改配置信息) 请仔细观看下面 getAllTask ， getTask ， writeRunLog ，updateTaskRunState 四个方法，并按要求实现类似结果 示例代码如下: ``` return [ 'enable' => true, 'listen' => '0.0.0.0:2345', 'debug' => true, //控制台输出日志 'write_log' => true,// 是否记录任务日志 'redis' => [ 'host' => 'redis://127.0.0.1:6379', 'options' => [ 'auth' => null, // 密码，字符串类型，可选参数 ] ], 'task_handle' => [ //任务操作类 1 => \FlyCms\WebmanCrontab\event\UrlTask::class, 2 => \FlyCms\WebmanCrontab\event\EvalTask::class, 3 => \FlyCms\WebmanCrontab\event\ShellTask::class ], 'getAllTask' => function(){ //获取所有任务 return \app\model\CrontabModel::select()->toArray(); }, 'getTask' => function($id){ //获取某个任务 return \app\model\CrontabModel::where('id',$id)->find(); }, 'writeRunLog' => function($insert_data){ //写入运行日志,注意，这个是日志模型，跟其它方法的模型不一样 \app\model\CrontabLogModel::insertGetId($insert_data); }, 'updateTaskRunState' => function($id, $last_running_time){ //更新任务最后运行时间,这里要把运行次数加 1 return \app\model\CrontabModel::where('id',$id) ->update([ 'last_running_time' => $last_running_time, 'running_times' => \think\facade\Db::raw(' running_times + 1') ]); } ]; ``` 接着打开 process.php 示例如下: ***count 设置定时任务进程数*** ***这里的端口要与上面配置的listen端口进行对应*** ***检查宝塔或者服务器对应防火墙端口是否打开*** ``` return [ 'webman-crontab' => [ 'handler' => \FlyCms\WebmanCrontab\Server::class, 'count' => 1, 'listen' => 'text://0.0.0.0:2345', ] ]; ``` 用法 -- [](#用法) 第一步,创建路由 ``` use app\admin\controller\TaskSet; use Webman\Route; Route::any('/admin/taskSet/index',[TaskSet::class,'index']); Route::any('/admin/taskSet/list',[TaskSet::class,'list']); Route::any('/admin/taskSet/edit',[TaskSet::class,'edit']); Route::any('/admin/taskSet/updateOne',[TaskSet::class,'updateOne']); Route::any('/admin/taskSet/get',[TaskSet::class,'get']); Route::any('/admin/taskSet/getLog',[TaskSet::class,'getLog']); Route::any('/admin/taskSet/reloadTask',[TaskSet::class,'reloadTask']); Route::any('/admin/taskSet/delete',[TaskSet::class,'delete']); ``` 第二步,导入插件test目录的TaskSet控制器类 ***这里你需要做的功能是*** 1 创建对应模型类 2 edit方法添加对应的参数校验 第三步，导入插件test目录的taskSet.html文件 因为删掉项目封装代码原因，该文件只实现部分功能，仅供参考，实际请根据自己项目功能去修改 扩展任务类型 ------ [](#扩展任务类型) 插件app.php目录里的 task\_handle 数组配置任务解析类。 ``` 'task_handle' => [ //任务操作类 1 => \FlyCms\WebmanCrontab\event\UrlTask::class, 2 => \FlyCms\WebmanCrontab\event\EvalTask::class, 3 => \FlyCms\WebmanCrontab\event\ShellTask::class, 4 => 'xxx解析类'， 5 => 'xxx解析类'， ], ``` 任务解析类你必须实现下面方法，并且返回code与log字段，code 0 代表成功，1 失败，log字段必须为string类型 ``` /** * @param $crontab * @return array */ public static function parse($crontab){ return ['log'=> $log, 'code' => $code]; } ``` 常见错误 ---- [](#常见错误) 1 未正确配置redis信息 2 未正确配置端口信息 3 未实现配置信息里面的 getAllTask ,getTask ,writeRunLog,updateTaskRunState四个方法 4 端口未放行导致无法通讯 ### Health Score 25 — LowBetter than 37% of packages Maintenance18 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community10 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor1 Top contributor holds 65.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~8 days Total 8 Last Release 1104d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a2a2840ccbd7094dc1b92ee89c9cf2fb54a13e20ab6b324fc38dac8246947976?d=identicon)[settime](/maintainers/settime) --- Top Contributors [![banlancegit](https://avatars.githubusercontent.com/u/32864986?v=4)](https://github.com/banlancegit "banlancegit (25 commits)")[![settime](https://avatars.githubusercontent.com/u/28994637?v=4)](https://github.com/settime "settime (13 commits)") ### Embed Badge ![Health badge](/badges/fly-cms-webman-crontab/health.svg) ``` [![Health](https://phpackages.com/badges/fly-cms-webman-crontab/health.svg)](https://phpackages.com/packages/fly-cms-webman-crontab) ``` ### Alternatives [topthink/think-worker workerman extend for thinkphp 202227.2k9](/packages/topthink-think-worker)[saithink/saiadmin webman plugin 2709.9k1](/packages/saithink-saiadmin)[workerman/redis-queue Message queue system written in PHP based on workerman and backed by Redis. 48183.9k11](/packages/workerman-redis-queue)[casbin/webman-permission webman casbin permission plugin 523.4k2](/packages/casbin-webman-permission)[cshaptx4869/http-crontab 接口化定时任务管理 112.1k](/packages/cshaptx4869-http-crontab)[teamones/casbin Teamones框架 casbin sdk 101.8k](/packages/teamones-casbin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)