PHPackages                             webman-tech/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. webman-tech/crontab-task

ActiveLibrary[Utility & Helpers](/categories/utility)

webman-tech/crontab-task
========================

Webman plugin webman-tech/crontab-task

v5.1.0(2w ago)72.7k1[1 issues](https://github.com/webman-tech/crontab-task/issues)MITPHPPHP ^8.2

Since May 11Pushed 2w ago1 watchersCompare

[ Source](https://github.com/webman-tech/crontab-task)[ Packagist](https://packagist.org/packages/webman-tech/crontab-task)[ RSS](/packages/webman-tech-crontab-task/feed)WikiDiscussions main Synced today

READMEChangelog (5)Dependencies (8)Versions (58)Used By (0)

webman-tech/crontab-task
========================

[](#webman-techcrontab-task)

本项目是从 [webman-tech/components-monorepo](https://github.com/orgs/webman-tech/components-monorepo) 自动 split 出来的，请勿直接修改

简介
--

[](#简介)

webman 定时任务管理插件，基于 [workerman/crontab](https://www.workerman.net/doc/webman/components/crontab.html) 实现，提供更加便捷的定时任务管理方式。

该插件解决了 webman 默认定时任务配置的一些问题：单进程下起多个定时任务存在阻塞问题、缺乏统一的日志记录机制、定时任务管理不够灵活。

功能特性
----

[](#功能特性)

- **灵活的进程管理**：支持单任务独立进程和多任务共享进程两种配置方式
- **完善的日志支持**：提供任务开始、结束、异常等常规日志记录
- **事件机制**：支持任务执行前后的事件处理
- **内存管理**：支持任务执行后自动释放内存
- **命令行工具**：提供查看和创建定时任务的命令
- **异常处理**：完善的异常处理机制，防止任务异常影响整个进程

安装
--

[](#安装)

```
composer require webman-tech/crontab-task
```

核心组件
----

[](#核心组件)

### BaseTask 基础任务类

[](#basetask-基础任务类)

[BaseTask](src/BaseTask.php) 是所有定时任务的基类，提供任务执行的完整生命周期管理。子类需实现 `handle()` 抽象方法编写具体业务逻辑，框架负责异常捕获、日志记录、事件触发和内存管理。异常分为两类：`TaskException` 记录为 warning 级别（业务异常），其他异常记录为 error 级别（系统异常）。

### Schedule 调度器

[](#schedule-调度器)

[Schedule](src/Schedule.php) 用于配置和管理定时任务进程，通过 `addTask()` 添加单个任务（独立进程）、`addTasks()` 添加多个任务（同一进程，注意阻塞问题），最后调用 `buildProcesses()` 构建进程配置数组。

### TaskProcess 任务进程

[](#taskprocess-任务进程)

[TaskProcess](src/TaskProcess.php) 是实际的任务进程类，负责验证任务配置的正确性，并在进程启动时注册和管理定时任务的执行。

命令行工具
-----

[](#命令行工具)

- `php webman crontab-task:list`：查看当前所有定时任务列表
- `php webman make:crontab-task MyTask`：快速创建定时任务类

AI 辅助
-----

[](#ai-辅助)

- **开发维护**：[AGENTS.md](AGENTS.md) — 面向 AI 的代码结构和开发规范说明
- **使用指南**：[skills/webman-tech-crontab-task-best-practices/SKILL.md](skills/webman-tech-crontab-task-best-practices/SKILL.md) — 面向 AI 的最佳实践，可安装到 Claude Code 的 skills 目录使用

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance93

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity71

Established project with proven stability

 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 ~21 days

Recently: every ~26 days

Total

56

Last Release

17d ago

Major Versions

v1.0.27 → v5.0.02025-11-24

PHP version history (2 changes)v1.1.0PHP >=7.4

v1.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/b4053cfc9956b8c15b9bc4c9c7c2bad625d16d1b6d9191019b2a25cc0972d955?d=identicon)[kriss](/maintainers/kriss)

---

Top Contributors

[![krissss](https://avatars.githubusercontent.com/u/10680903?v=4)](https://github.com/krissss "krissss (23 commits)")

---

Tags

crontabtaskwebman

### Embed Badge

![Health badge](/badges/webman-tech-crontab-task/health.svg)

```
[![Health](https://phpackages.com/badges/webman-tech-crontab-task/health.svg)](https://phpackages.com/packages/webman-tech-crontab-task)
```

###  Alternatives

[saithink/saiadmin

webman plugin

28111.0k1](/packages/saithink-saiadmin)[webman-tech/auth

webman auth plugin

147.1k1](/packages/webman-tech-auth)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)