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(3y ago)1138.7k—0%7[3 issues](https://github.com/Flowpack/task/issues)[3 PRs](https://github.com/Flowpack/task/pulls)1MITPHPPHP >=7.4

Since Aug 1Pushed 3y ago13 watchersCompare

[ Source](https://github.com/Flowpack/task)[ Packagist](https://packagist.org/packages/flowpack/task)[ RSS](/packages/flowpack-task/feed)WikiDiscussions main Synced 2d 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

35

—

LowBetter than 77% of packages

Maintenance15

Infrequent updates — may be unmaintained

Popularity37

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity57

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

1127d 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

[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[oro/platform

Business Application Platform (BAP)

645143.5k115](/packages/oro-platform)[pimcore/data-importer

Adds a comprehensive import functionality to Pimcore Datahub

46855.5k5](/packages/pimcore-data-importer)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)

PHPackages © 2026

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