PHPackages                             garvinhicking/adhoc-tasks - 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. [CLI & Console](/categories/cli)
4. /
5. garvinhicking/adhoc-tasks

ActiveTypo3-cms-extension[CLI & Console](/categories/cli)

garvinhicking/adhoc-tasks
=========================

TYPO3 Scheduler AdHoc Tasks - allows to run any TYPO3 (v14+) Scheduler Task on the command line, with custom configuration.

0.1.0(7mo ago)22[1 issues](https://github.com/garvinhicking/typo3-adhoc-tasks/issues)GPL-2.0-or-laterShell

Since Nov 26Pushed 7mo agoCompare

[ Source](https://github.com/garvinhicking/typo3-adhoc-tasks)[ Packagist](https://packagist.org/packages/garvinhicking/adhoc-tasks)[ Docs](https://typo3.org)[ RSS](/packages/garvinhicking-adhoc-tasks/feed)WikiDiscussions main Synced today

READMEChangelog (1)Dependencies (11)Versions (2)Used By (0)

typo3-adhoc-tasks
=================

[](#typo3-adhoc-tasks)

Allows to run any TYPO3 (v14) Scheduler Task on the command line, with custom configuration

This was originally proposed as .

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

[](#installation)

This package can be installed (in TYPO3 v14) as a composer package:

```
composer req "garvinhicking/adhoc-tasks"

```

See packagist:

No "classic mode" support is planned for this extension.

Description
-----------

[](#description)

With the reworked scheduler data storage format of TYPO3 v14 () this opened up the possibility to have "ad-hoc" tasks.

Previously, the TYPO3 scheduler tasks that were extended from `AbstractTask`did not allow to be run without specific configuration. They needed to be stored as a task in the database, containing serialized parameters/arguments.

This meant, that these tasks could only be run from `typo3/bin/typo3 scheduler:execute`if they had a corresponding serialized task database entry, and could not be run with different configuration on the CLI, or at all.

To bypass this, the recommendation was to create all tasks as Symfony Commands, which also allowed CLI execution. This is still a recommendation for today.

However, several TYPO3 core tasks still exist (like for garbage collection, file reference integrity and others) and these are now executable as ad-hoc tasks, without the need to refactor every `AbstractTask` into a Symfony Command.

Ad-hoc tasks can be executed like:

```
bin/typo3 scheduler:adhoc:execute
  --task 'TYPO3\CMS\Scheduler\Task\OptimizeDatabaseTableTask'
  --config='{"selected_tables": "be_dashboards,be_groups"}'

```

The two new options `--task` and `--config` specify the unique ID of a task to execute (currently a fully-qualified classname, in the future probably shorthand IDs), and passes the arguments as a JSON string.

The choice to put a serialized JSON string as arguments has several advantages:

- It can be the same JSON string as stored in the `tx_scheduler_task.parameters`database column.
- It allows to specify newlines and array-types on the CLI
- It prevents the need to define, pass-through and validate arbitrary CLI arguments

> **HINT**: The list of available parameters of a given task type can be investigated via:
>
> ```
> bin/typo3 scheduler:adhoc:execute
>   --task 'TYPO3\CMS\Scheduler\Task\OptimizeDatabaseTableTask'
>   --config='?'
>
> ```

A second command `bin/typo3 scheduler:adhoc:list` shows a list of all ad-hoc tasks that are available, with a list of their parameters.

Impact
------

[](#impact)

All TYPO3 Core tasks and custom `AbstractTask` implementations utilizing the "native task" TCA format can now be run from the CLI and no longer need "dummy" entries in the Scheduler.

This helps for debugging tasks as well as one-off runs of a specific task.

TODO
----

[](#todo)

Tests were adapted from the TYPO3 Core patch. They do not (yet) work standalone due to difference in how Symfony CLI commands can be tested.

###  Health Score

23

—

LowBetter than 26% of packages

Maintenance54

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity25

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

219d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/273326?v=4)[Garvin Hicking](/maintainers/garvinhicking)[@garvinhicking](https://github.com/garvinhicking)

---

Top Contributors

[![garvinhicking](https://avatars.githubusercontent.com/u/273326?v=4)](https://github.com/garvinhicking "garvinhicking (8 commits)")

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/garvinhicking-adhoc-tasks/health.svg)

```
[![Health](https://phpackages.com/badges/garvinhicking-adhoc-tasks/health.svg)](https://phpackages.com/packages/garvinhicking-adhoc-tasks)
```

###  Alternatives

[aimeos/aimeos-typo3

Professional, full-featured and high performance TYPO3 e-commerce extension for online shops and complex B2B projects

1.5k94.0k6](/packages/aimeos-aimeos-typo3)[helhum/typo3-console

A reliable and powerful command line interface for TYPO3 CMS

2959.5M254](/packages/helhum-typo3-console)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

611.1M8](/packages/netresearch-rte-ckeditor-image)[wazum/sluggi

TYPO3 extension for URL slug management with inline editing, auto-sync, locking, access control, and redirects

40529.5k](/packages/wazum-sluggi)[b13/assetcollector

Asset collector - Add CSS and SVG files and strings as inline style tag/inline svg to the html code.

10125.6k](/packages/b13-assetcollector)

PHPackages © 2026

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