PHPackages                             flowpack/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. flowpack/task

ActiveNeos-package[Utility & Helpers](/categories/utility)

flowpack/task
=============

A Task scheduler for Neos Flow

1.2.1(2y ago)1136.3k↓20.6%7[3 PRs](https://github.com/Flowpack/task/pulls)1MITPHPPHP >=7.4

Since Aug 1Pushed 2y ago13 watchersCompare

[ Source](https://github.com/Flowpack/task)[ Packagist](https://packagist.org/packages/flowpack/task)[ RSS](/packages/flowpack-task/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (3)Versions (9)Used By (1)

Flow Framework Task Scheduler
=============================

[](#flow-framework-task-scheduler)

[![Latest Stable Version](https://camo.githubusercontent.com/de14f5648ae8a9244c2f811fe658486fc84f013d30ba4aa3a6530a2eeaa3cac7/68747470733a2f2f706f7365722e707567782e6f72672f666c6f777061636b2f7461736b2f762f737461626c65)](https://packagist.org/packages/flowpack/task) [![Total Downloads](https://camo.githubusercontent.com/570f282691babc5cc869d6c7e1de534ab026522513d55ebb5fdd5c4cf9bac607/68747470733a2f2f706f7365722e707567782e6f72672f666c6f777061636b2f7461736b2f646f776e6c6f616473)](https://packagist.org/packages/flowpack/task) [![License](https://camo.githubusercontent.com/2d500e964b5a5be2f5951c22360ab231c98b561ec034a3fc1771b3880a0f6004/68747470733a2f2f706f7365722e707567782e6f72672f666c6f777061636b2f7461736b2f6c6963656e7365)](https://packagist.org/packages/flowpack/task)

This package provides a simple to use task scheduler for Neos Flow. Tasks are configured via settings, recurring tasks can be configured using cron syntax. Detailed options configure the first and last executions as well as options for the class handling the task.

Scheduling and running tasks are decoupled: The `Scheduler` schedules tasks whcih the are executed by the `TaskRunner`. This architecture allows receiving and displaying metrics of already executed tasks.

Most of the architectural ideas behind the package are taken from [php-task](https://github.com/php-task/php-task), and reimplemented for Neos Flow.

Installation
------------

[](#installation)

```
composer require 'flowpack/task'
```

Configuration
-------------

[](#configuration)

### Defining A Task

[](#defining-a-task)

```
Flowpack:
  Task:
    tasks:
      'a-unique-identifier':
        label: The label of this task
        description: Some detailed description of this task
        # A class, implementing the TaskHandlerInterface
        handlerClass: 'Vendor\Package\TaskHandler\TaskHandlerClass'
        cronExpression: '*/5 * * * *'
        # A workload, eg. some configuration, given to the taskHandler
        workload:
          interval: PT5M
```

### General Options

[](#general-options)

- `lockStorage`: Configuration string for the lock storage used for taskHandler implementing `LockingTaskHandlerInterface`. See  for more options
- `keepTaskExecutionHistory`: Number of task executions to keep in the database. (default: 3)

Implementing A Task Handler
---------------------------

[](#implementing-a-task-handler)

A task handler contains the code executed for a specific task. Your command handler has to implement one of the following interfaces:

`Flowpack\Task\TaskHandler\TaskHandlerInterface`

A basic task. The interface requires the method `handle(WorkloadInterface $workload): string` to be implemented. The return value serves as information for successfully executed tasks.

`Flowpack\Task\TaskHandler\RetryTaskHandlerInterface`

Also requires `getMaximumAttempts(): int` to be implemented. Allowing the tasks to be retried on failure.

`Flowpack\Task\TaskHandler\LockingTaskHandlerInterface`

Also requires `getLockIdentifier(WorkloadInterface $workload): string` to be implemented. The return value specifies a lock to be acquired. When such a task is running, other tasks requiring the same lock will be skipped.

Available Commands
------------------

[](#available-commands)

Schedule and run due tasks

```
./flow task:run
```

Schedule and run a single task

```
./flow task:runSingle
```

Show a list of all defined and scheduled tasks:

```
./flow task:list
```

Show details about a specific task:

```
./flow task:show
```

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity37

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 83% 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 ~111 days

Recently: every ~153 days

Total

7

Last Release

1081d ago

Major Versions

0.1.0 → 1.0.02021-09-17

### Community

Maintainers

![](https://www.gravatar.com/avatar/25d49a6af82b72d2764774a05c307808375016d7aeaaef3862472a6580ff38a7?d=identicon)[flowpack](/maintainers/flowpack)

---

Top Contributors

[![daniellienert](https://avatars.githubusercontent.com/u/642226?v=4)](https://github.com/daniellienert "daniellienert (39 commits)")[![bwaidelich](https://avatars.githubusercontent.com/u/307571?v=4)](https://github.com/bwaidelich "bwaidelich (3 commits)")[![gjwnc](https://avatars.githubusercontent.com/u/19683930?v=4)](https://github.com/gjwnc "gjwnc (3 commits)")[![erkenes](https://avatars.githubusercontent.com/u/8766722?v=4)](https://github.com/erkenes "erkenes (1 commits)")[![riea](https://avatars.githubusercontent.com/u/10829329?v=4)](https://github.com/riea "riea (1 commits)")

---

Tags

hacktoberfestschedulertask-runner

### Embed Badge

![Health badge](/badges/flowpack-task/health.svg)

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

###  Alternatives

[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)[synolia/sylius-scheduler-command-plugin

Scheduler Command Plugin.

34361.5k](/packages/synolia-sylius-scheduler-command-plugin)[neos/eel

The Embedded Expression Language (Eel) is a building block for creating Domain Specific Languages

122.0M27](/packages/neos-eel)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[avency/neos-vardump

Neos VarDump Package

147.1k](/packages/avency-neos-vardump)

PHPackages © 2026

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