PHPackages xianrenqh/webman-crontab-task - 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. [Utility & Helpers](/categories/utility) 4. / 5. xianrenqh/webman-crontab-task ActiveLibrary[Utility & Helpers](/categories/utility) xianrenqh/webman-crontab-task ============================= dynamic crontab task plugin for webman. v0.4.5(5mo ago)21991MITPHPPHP >=8.1 Since Jun 8Pushed 5mo ago1 watchersCompare [ Source](https://github.com/xianrenqh/webman-crontab-task)[ Packagist](https://packagist.org/packages/xianrenqh/webman-crontab-task)[ RSS](/packages/xianrenqh-webman-crontab-task/feed)WikiDiscussions master Synced today READMEChangelog (9)Dependencies (3)Versions (10)Used By (0) 动态秒级定时任务 ======== [](#动态秒级定时任务) 概述 -- [](#概述) 基于 **webman** + **TP-ORM** 的动态秒级定时任务管理，兼容 Windows 和 Linux 系统。 > php >= 8.1 ### 原项目 [](#原项目) 基于原作者项目更改的部分适合自己使用的模块插件 原项目地址： 喜欢原版的请移步原作者 【原旧版本->改动】 1. 修改创建数据库时候的部分字段未设置默认值的bug 2. 更改必须使用execute方法，可以使用自定义方法【自定义方法请写到：target 后面，例如：app\\common\\crontab\\ClearLogCrontab\\test】 3. 修复禁用、暂停、在下一分钟才生效的bug 4. 新增立即重启功能 5. 新增任务日志设置项 6. 插件默认关闭状态，如需启动，请在配置文件中修改enable=true ### 安装 [](#安装) ``` composer require xianrenqh/webman-crontab-task ``` ### 重要提示： [](#重要提示) 1. windows用户 启动webman 使用 windows.php 2. 使用前请先确认是否composer已安装以下3个插件： - workerman/crontab - webman/think-orm - guzzlehttp/guzzle ### 定时器格式说明: [](#定时器格式说明) ``` 0 1 2 3 4 5 | | | | | | | | | | | +------ day of week (0 - 6) (Sunday=0) | | | | +------ month (1 - 12) | | | +-------- day of month (1 - 31) | | +---------- hour (0 - 23) | +------------ min (0 - 59) +-------------- sec (0-59)[可省略，如果没有0位,则最小时间粒度是分钟] ``` 简单使用 ---- [](#简单使用) ``` $param = [ 'method' => 'crontabIndex',//计划任务列表 'args' => ['limit' => 10, 'page' => 1]//参数 ]; $result= xianrenqh\Task\Client::instance()->request($param); return json($result); ``` ### 任务分类 [](#任务分类) - url 任务可以指定一个url地址来请求，没有什么可解释的。 - eval 任务可以直接写入 php 代码，但代码请不要带 ，具体查阅 eval 函数 - Class 任务必须指定带有 命名空间的类名，并且实现一个 public 属性的方法：方法返回值为 bool / string 类型 - Command 任务请先按照 webman 官方文档定义好执行命令，在新增任务，输入定义的 命令 即可 例如：php webman version 或者 version - Shell 任务 在新增任务，输入定义的 shell命令 即可 例如：ps -ef | grep php 计划任务列表 ------ [](#计划任务列表) ### 方法名 [](#方法名) **method：** crontabIndex ### 请求参数 [](#请求参数) **args** 参数名称是否必须示例备注page是1页码limit是15每页条数### 返回数据 [](#返回数据) ``` { "code": 200, "msg": "ok", "data": { "total": 4, "per_page": 15, "current_page": 1, "last_page": 1, "data": [ { "id": 6, "title": "class任务 每月1号清理所有日志", "type": 2, "rule": "0 0 1 * ", "target": "app\common\crontab\ClearLogCrontab", "parameter": "", "running_times": 71, "last_running_time": 1651121710, "remark": "", "sort": 0, "status": 1, "create_time": 1651114277, "update_time": 1651114277, "singleton": 1 }, { "id": 5, "title": "eavl任务 输出 hello world", "type": 4, "rule": " * * * ", "target": "echo 'hello world';", "parameter": "", "running_times": 25, "last_running_time": 1651121701, "remark": "", "sort": 0, "status": 1, "create_time": 1651113561, "update_time": 1651113561, "singleton": 0 }, { "id": 3, "title": "url任务 打开 workerman 网站", "type": 3, "rule": "/20 * * * * ", "target": "https://www.workerman.net/", "parameter": "", "running_times": 39, "last_running_time": 1651121700, "remark": "请求workerman网站", "sort": 0, "status": 1, "create_time": 1651112925, "update_time": 1651112925, "singleton": 0 }, { "id": 1, "title": "command任务 输出 webman 版本", "type": 1, "rule": "/20 * * * * *", "target": "version", "parameter": null, "running_times": 112, "last_running_time": 1651121700, "remark": "20秒", "sort": 0, "status": 1, "create_time": 1651047480, "update_time": 1651047480, "singleton": 1 } ] } } ``` 计划任务日志列表 -------- [](#计划任务日志列表) **method：** crontabLog ### 请求参数 [](#请求参数-1) **args** 参数名称是否必须示例备注page是1页码limit是15每页条数crontab\_id否1计划任务ID### 返回数据 [](#返回数据-1) ``` { "code": 200, "msg": "ok", "data": { "total": 97, "per_page": 15, "current_page": 1, "last_page": 7, "data": [ { "id": 257, "crontab_id": 1, "target": "version", "parameter": "", "exception": "Webman-framework v1.3.11", "return_code": 0, "running_time": "0.834571", "create_time": 1651123800, "update_time": 1651123800 }, { "id": 251, "crontab_id": 1, "target": "php webman version", "parameter": "", "exception": "Webman-framework v1.3.11", "return_code": 0, "running_time": "0.540384", "create_time": 1651121700, "update_time": 1651121700 }, { "id": 246, "crontab_id": 1, "target": "php webman version", "parameter": "{}", "exception": "Webman-framework v1.3.11", "return_code": 0, "running_time": "0.316019", "create_time": 1651121640, "update_time": 1651121640 }, { "id": 244, "crontab_id": 1, "target": "php webman version", "parameter": "{}", "exception": "Webman-framework v1.3.11", "return_code": 0, "running_time": "0.493848", "create_time": 1651121580, "update_time": 1651121580 } ] } } ``` 添加任务 ---- [](#添加任务) **method：** crontabCreate ### 请求参数 [](#请求参数-2) **args** 参数名称参数类型是否必须示例备注titletext是输出 webman 版本任务标题typetext是1任务类型 (1 command, 2 class, 3 url, 4 eval ,5 shell)ruletext是\*/3 \* \* \* \* \*任务执行表达式targettext是php webman version/ version调用任务字符串parametertext否{}调用任务参数(url和eval无效)remarktext是每3秒执行备注sorttext是0排序statustext是1状态\[0禁用; 1启用\]singletontext否1是否单次执行 \[0 是 1 不是\]### 返回数据 [](#返回数据-2) ``` { "code": 200, "msg": "ok", "data": {} } ``` 重启任务 ---- [](#重启任务) **method：** crontabReload ### 请求参数 [](#请求参数-3) **args** 参数名称参数类型是否必须示例备注idtext是1,2计划任务ID 多个逗号隔开### 返回数据 [](#返回数据-3) ``` { "code": 200, "msg": "ok", "data": {} } ``` 修改任务 ---- [](#修改任务) **method：** crontabUpdate ### 请求参数 [](#请求参数-4) **args** 参数名称参数类型是否必须示例备注idtext是1titletext否输出 webman 版本任务标题typetext否1任务类型 (1 command, 2 class, 3 url, 4 eval，5 shell)ruletext否\*/3 \* \* \* \* \*任务执行表达式targettext否php webman version/version调用任务字符串parametertext否{}调用任务参数(url和eval无效)remarktext否每3秒执行备注sorttext否0排序statustext否1状态\[0禁用; 1启用\]singletontext否1是否单次执行 \[0 是 1 不是\]``` //使用类【type=2】的添加案例 $request = [ 'method' => 'crontabCreate', 'args' => [ 'title' => '检测设备心跳', 'type' => 2, 'rule' => '*/3 * * * * *', 'target' => 'app\api\crontab\HeartCrontab\checkheart', 'status' => 1, 'remark' => '每3秒执行', ] ]; $result = \xianrenqh\Task\Client::instance()->request($request); return json($result); ``` ### 返回数据 [](#返回数据-4) ``` { "code": 200, "msg": "ok", "data": {} } ``` 删除任务 ---- [](#删除任务) **method：** crontabDelete ### 请求参数 [](#请求参数-5) **args** 参数名称参数类型是否必须示例备注idtext是1,2计划任务ID 多个逗号隔开### 返回数据 [](#返回数据-5) ``` { "code": 200, "msg": "ok", "data": { } } ``` 立即执行任务 ------ [](#立即执行任务) **method：** crontabExecuteNow ### 请求参数 [](#请求参数-6) **args** 参数名称参数类型是否必须示例备注idtext是1计划任务IDasyncbool否false是否异步执行，默认同步### 返回数据 [](#返回数据-6) ``` { "code": 200, "msg": "任务已提交执行", "data": {} } ``` ### Health Score 39 — LowBetter than 85% of packages Maintenance72 Regular maintenance activity Popularity15 Limited adoption so far Community8 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~159 days Recently: every ~247 days Total 9 Last Release 156d ago PHP version history (2 changes)v0.01PHP >=7.4 v0.4.5PHP >=8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/ed4f84e03b6cfd0431c149514b0d5a0186271f2922b96bf2c59931e6308b6fcf?d=identicon)[xianrenqh](/maintainers/xianrenqh) --- Top Contributors [![xianrenqh](https://avatars.githubusercontent.com/u/16522281?v=4)](https://github.com/xianrenqh "xianrenqh (3 commits)") --- Tags taskcrontabwebman ### Embed Badge ![Health badge](/badges/xianrenqh-webman-crontab-task/health.svg) ``` [![Health](https://phpackages.com/badges/xianrenqh-webman-crontab-task/health.svg)](https://phpackages.com/packages/xianrenqh-webman-crontab-task) ``` ### Alternatives [phing/phing PHing Is Not GNU make; it's a PHP project build system or build tool based on Apache Ant. 1.2k21.7M871](/packages/phing-phing)[saithink/saiadmin webman plugin 2709.9k1](/packages/saithink-saiadmin)[yzh52521/webman-task dynamic crontab task plugin for webman. 171.9k2](/packages/yzh52521-webman-task)[hyperf/crontab A crontab component for Hyperf. 131.6M62](/packages/hyperf-crontab)[arrowjustdoit/crontab Crontab extension for laravel-admin 334.0k](/packages/arrowjustdoit-crontab) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)