Task management 

A task is created by extending the Scheduler base class and then registering it so that it appears in the Scheduler backend module.

Screenshots 

Below is the Scheduler backend module, showing a task that has been registered. The module shows details about the tasks, i.e. status, type and whether it failed during the last execution, and individual tasks can be rerun manually by clicking on the 'play' button.

Task execution 

The Scheduler includes a command-line script that needs to be registered once in the server's crontab to set it up. It is run by the TYPO3 command-line dispatcher. Every time the Scheduler is launched by the cron daemon it looks for tasks that are due (or overdue) and executes them.

When a task is executed it is marked as being executed in the Scheduler database record (in the serialized_executions field). When the task has finished running, the execution status is removed from the database record. This makes it clear whether a task is currently running and also prevents multiple executions. If a task requires more time to run than the frequency it is set up for, a new run will start (which is not always desirable). It is possible to prevent such parallel (or multiple) executions.

Follow-up 

Log messages are written out to the TYPO3 system Administration > Log when a task starts and ends and when parallel execution has been blocked. This provides a trace of events of the tasks.

A task that fails may also raise an exception reporting the reasons for failure. The exception message will be logged in the Scheduler database table and displayed in the backend module.

Tasks have no command-line output as they are designed to run in the background.

Symfony Console commands can also be run as tasks (see Console commands (CLI)). These tasks can specify all commandline arguments that are available to Symfony Console commands.

Glossary 

Task

Specifically, a piece of code that does a precise task and can be registered with the Scheduler in order to execute that piece of code at a precise time, either once or recurrently.

Task class

A type of task, for example, the "IP Anonymization" task is one particular task class. Its function is to anonymize IP addresses to enforce the privacy of persisted data. The "Optimize MySQL database tables" task executes "OPTIMIZE TABLE" statements on selected database tables.

Registered task

An instance of a task class that has been registered with the Scheduler. A given task class may be registered several times, for example if it needs to be executed with different parameters.

Credits 

The Scheduler is a derivation of the Gabriel extension originally developed by Christian Jul Jensen and further developed by Markus Friedrich.

Installation with Composer 

Check whether you are already using the extension with:

composer show | grep scheduler

This should either give you no result or something similar to:

typo3/cms-scheduler       v12.4.11

If it is not installed yet, use the composer require command to install the extension:

composer require typo3/cms-scheduler

The given version depends on the version of the TYPO3 Core you are using.

Classic installation without Composer 

In an installation without Composer, the extension is already shipped but might not be activated yet. Activate it as follows:

1. In the backend, navigate to the System > Extensions module.
2. Click the Activate icon for the Scheduler extension.

Next steps 

Once the extension is installed, the following setting is available:

• Maximum lifetime : it may happen that a task crashes while executing. In this case it will stay in a state marked as "running". That may prevent it from being executed again, if parallel executions are denied (see "Tasks execution" above). The maximum lifetime parameter ensures that old executions are removed after a while. The lifetime is expressed in minutes . The default is 15 minutes.

Choosing a frequency 

Whatever system the Scheduler will run on, the first step is to define the frequency at which it should run. The Scheduler script should set up to run pretty often, but not unnecessarily often either. The frequency should be that of the most often running task or some frequency that fits all tasks.

For example, if you have some tasks running every quarter of an hour and some others running every hour, it is useless to have the Scheduler run every 5 minutes. On the other hand, if you have tasks scheduled to run every 10 minutes and others every 15 minutes, you will want to run the Scheduler every 5 minutes. Indeed, if you run it only at 10-minute intervals, it will run – assuming it is 8 o'clock – at 08:10, 08:20, 08:30, etc. So the tasks that should run at 08:15 will actually run 5 minutes late.

On Unix and Mac OS X 

On such systems the Scheduler must be set up as a cron job. There are several ways to achieve this, although the simplest is probably to add it to some user's crontab. Edit that user's crontab using:

crontab -e

and add a line like

*/15 * * * * /usr/local/bin/php /home/user/www/vendor/bin/typo3 scheduler:run

*/15 * * * * /usr/local/bin/php /home/user/www/typo3/sysext/core/bin/typo3 scheduler:run

Save the modified crontab. Obviously, the paths have to be adapted to your system. The above command will call up the Scheduler every 15 minutes.

If you are editing system crontabs (for example /etc/crontab and /etc/cron.d/* ), there will be one additional parameter to enter, i.e. the user with which the job should run. Example:

*/15 * * * * www /usr/local/bin/php /home/user/www/vendor/bin/typo3 scheduler:run

*/15 * * * * www /usr/local/bin/php /home/user/www/typo3/sysext/core/bin/typo3 scheduler:run

This will run the job as user "www".

If you are not familiar with cron syntax, refer to some Unix administration book or start with the Wikipedia page about it (https://en.wikipedia.org/wiki/Cron).

On Windows 

On Windows, cron jobs are called "Scheduled tasks" and run with the schtasks utility. SchTasks.exe performs operations similar to those provided by Scheduled Tasks in the Control Panel. You can use either tool to create, delete, configure, or simply display scheduled tasks.

Assuming you want to run the TYPO3 Scheduler every 15 minutes, use the following command line to create a new task:

schtasks /create /sc minute /mo 15 /tn "T3scheduler" /tr "c:\winstaller\php\php.exe c:\winstaller\htdocs\quickstart\vendor\bin\typo3 scheduler:run"

schtasks /create /sc minute /mo 15 /tn "T3scheduler" /tr "c:\winstaller\php\php.exe c:\winstaller\htdocs\quickstart\typo3/sysext/core/bin/typo3 scheduler:run"

At task creation you will be prompted to give a password or you can use the /u and /p switches to provide user and password information. Note that the user must be a member of the Administrators group on the computer where the command will run.

The full reference for schtasks is available at: https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/schtasks

Providing custom tasks from your extension 

More tasks are provided by system extensions, such as the Extension Manager, which defines one for updating the available extensions list.

The base tasks are also there to serve as examples for task developers (see Scheduler task development).

Using the garbage collection task 

The task can be registered to clean up a particular table, in which case you simply choose the table and the minimum age of the records to delete from the task configuration screen.

In case no minimum age is choosen, the configured expirePeriod is used.

It is also possible to clean up all configured table by checking the "Clean all available tables" box.

The configuration for the tables to clean up is stored in the TCA of table tx_scheduler_task, in field tables.

This configuration is an array with the table names as fields and the following entries:

• option expireField can be used to point to a table field containing an expiry timestamp. This timestamp will then be used to decide whether a record has expired or not. If its timestamp is in the past, the record will be deleted.
• if a table has no expiry field, one can use a combination of a date field and an expiry period to decide which records should be deleted. The corresponding options are dateField and expirePeriod . The expiry period is expressed in days.

Example: Configure additional tables for the "Garbage Collection" task 

<?php

use TYPO3\CMS\Scheduler\Task\TableGarbageCollectionTask;

if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
    $garbageCollectionTables =& $GLOBALS['TCA']['tx_scheduler_task']['types'][TableGarbageCollectionTask::class]['taskOptions']['tables'];

    $garbageCollectionTables = array_replace($garbageCollectionTables ?? [], [
        'tx_myextension_my_table' => [
            'dateField' => 'tstamp',
            'expirePeriod' => 180,
        ],
        'tx_myextension_my_other_table' => [
            'expireField' => 'expire',
        ],
    ]);
}

The first part of the configuration indicates that records older than 180 days should be removed from table tx_myextension_my_table , based on the timestamp field called "tstamp". The second part indicates that old records should be removed from table tx_myextension_my_other_table directly based on the field expire which contains expiration dates for each record.

Migration: Supporting custom tables for garbage collection for both TYPO3 13 and 14 

If your extension supports both TYPO3 13 (or below) and 14 keep the registration of additional tables in the extensions ext_localconf.php until support for TYPO3 13 is removed:

<?php

use TYPO3\CMS\Core\Information\Typo3Version;
use TYPO3\CMS\Scheduler\Task\TableGarbageCollectionTask;

if ((new Typo3Version())->getMajorVersion() < 14) {
    // TODO: Remove once TYPO3 13 support is dropped
    // TYPO3 14 configuration can be found in Configuration/TCA/Overrides/tx_scheduler_garbage_collection.php
    $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks'][TableGarbageCollectionTask::class]['options']['tables']['tx_myextension_errorlog'] = [
        'dateField' => 'tstamp',
        'expirePeriod' => '180',
    ];
    $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks'][TableGarbageCollectionTask::class]['options']['tables']['tx_myextension_uniqalias'] = [
        'expireField' => 'expire',
    ];
}

Example: Configure additional tables for the "IP Anonymization" task 

<?php

use TYPO3\CMS\Scheduler\Task\IpAnonymizationTask;

if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
    $garbageCollectionTables =& $GLOBALS['TCA']['tx_scheduler_task']['types'][IpAnonymizationTask::class]['taskOptions']['tables'];

    $garbageCollectionTables = array_replace($garbageCollectionTables ?? [], [
        'tx_myextension_my_table' => [
            'dateField' => 'tstamp',
            'ipField' => 'private_ip',
        ],
    ]);
}

This entry configures that the field private_ip of table tx_myextension_my_table can be anonymized after a chosen number of days.

The field tstamp will be taken into account to determine when the database record was last changed.

Migration: Supporting custom tables for "IP Anonymization" tasks for both TYPO3 13 and 14 

If your extension supports both TYPO3 13 (or below) and 14 keep the registration of additional tables in the extensions ext_localconf.php until support for TYPO3 13 is removed:

<?php

use TYPO3\CMS\Core\Information\Typo3Version;
use TYPO3\CMS\Scheduler\Task\IpAnonymizationTask;

if ((new Typo3Version())->getMajorVersion() < 14) {
    // TODO: Remove once TYPO3 13 support is dropped
    // TYPO3 14 configuration can be found in Configuration/TCA/Overrides/tx_scheduler_ip_anonymization.php
    $garbageCollectionTables =& $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks'][IpAnonymizationTask::class]['options']['tables'];

    $garbageCollectionTables = array_replace($garbageCollectionTables ?? [], [
        'tx_myextension_my_table' => [
            'dateField' => 'tstamp',
            'ipField' => 'private_ip',
        ],
    ]);
}

The setup check screen 

This screen has already been mentioned in the Installation chapter. It is mostly useful when setting up the Scheduler, as it indicates whether the CLI script is executable or not. When everything is running fine, it contains mostly one useful piece of information: when the last run took place, when it ended and whether it was started manually (i.e. from the BE module) or automatically (i.e. from the command line).

The scheduled tasks screen 

This is the main screen when administering tasks. At first it will be empty and just offer a link to add a new task. When such registered tasks exists, this screen will show a list with various pieces of information.

Disabled tasks have a gray label sign near the task name. A disabled task is a task that will not be run automatically by the command-line script, but may still be executed from the BE module.

A late task will appear with an orange label sign near the task name:

The task list can be sorted by clicking the column label. With every click it switches between ascending and descending order of the items of the associated column.

The table at the center of the above screenshot shows the following:

• The first column contains checkboxes. Clicking on a checkbox will select that particular scheduled task for immediate execution. Clicking on the icon at the top of the column will toggle all checkboxes. To execute the selected tasks, click on the "Execute selected tasks" button. Read more in "Manually executing a task" below.
• The second column simply displays the id of the task.
• The third column contains the name of the task, the extension it is coming from and any additional information specific to the task. It also shows a summary of the task's status with an icon.
• The fourth column shows whether the task is recurring or will run only a single time.
• The fifth column shows the frequency.
• The sixth columns indicates whether parallel executions are allowed or not.
• The seventh column shows the last execution time and indicates whether the task was launched manually or was run via the command-line script (cron).
• The eighth column shows the planned execution time. If the task is overdue, the time will show up in bold, red numbers. A task may have no future execution date if it has reached its end date, if it was meant to run a single time and that execution is done, or if the task is disabled. The next execution time is also hidden for running tasks, as this information makes no sense at that point in time.
• The last column contains possible actions, mainly editing, disable or deleting a task. There are also buttons for running the task on the next cron job or run it directly. The actions will be unavailable for a task that is currently running, as it is unwise to edit or delete it a task in such a case. Instead a running task will display a "stop" button (see "Stopping a task" below).

Note that all dates and times are displayed in the server's time zone. The server time appears at the bottom of the screen.

At the top of the screen is a link to add a new task. If there are a lot of tasks that appear late, consider changing the frequency at which the cron job is running (see "Choosing a frequency" above).

Occasionally the following display may appear:

This will typically happen when a task provided by some extension was registered, then the extension was uninstalled, but the task was not deleted beforehand. In such a case, this task stays but the Scheduler doesn't know how to handle it anymore. The solution is either to install the related extension again or delete the registered task.

The scheduler task wizard 

The scheduler task form 

When adding or editing a task, the following form will show up:

Some fields require additional explanations (inline help is available by moving the mouse over the field labels):

• A disabled task will be skipped by the command-line script. It may still be launched manually, as described above.

It is possible to invoke the Ctrl/Cmd + s hotkey to save a scheduler task, altogether with the hotkey Ctrl/Cmd + Shift + S to save and close a scheduler task.

Scheduler task settings 

Some tasks allow additional settings to be made in the area Settings. These fields differ from task to task

Task executions timing details 

• A task must have a start date. It defaults to the time of creation. The server's time appears at the bottom of the form.
• Task can be run a single time or recurring.
• The frequency needs be entered only for recurring tasks. It can be either an integer number of seconds or a cron-like schedule expression. Scheduler supports ranges, steps and keywords like @weekly. See en.wikipedia.org for more information. See \TYPO3\CMS\Scheduler\CronCommand\CronCommand and \TYPO3\CMS\Scheduler\CronCommand\NormalizeCommand class references in the TYPO3 CMS source code for definitive rules.
• Parallel executions are denied for recurring tasks. They can be allowed by checking "Allow Parallel Execution"

If an error occurs when validating a cron definition, the Scheduler's built-in cron parser tries to provide an explanation about what's wrong.

Restoring a deleted scheduler task 

If the system extension typo3/cms-recycler is installed, go to module Content > Recycler.

Choose the page root (page 0) in the page tree, all scheduler tasks are stored here.

You can use the field "Type" to filter for "Scheduler task" only.

Editing task groups 

Scheduler task groups can be created, edited and deleted from the module Administration > Scheduler.

Technically they are records stored on the root page (pid=0). They can also be created, edited and sorted with module Content > Records.

It is also possible to create a new task group from within the edit task form by clicking on the + icon next to the task group select box.

Disabling task groups 

You can use button Disable group to disable all tasks in a group at once.

Tasks in a disabled group, just like disabled tasks in general are not executed when the scheduler is called by the cron job. They can, however, be executed manually by clicking the Run task button.

Stopping a task via console command 

You can also use a command to stop the task:

# Note the id of the task
vendor/bin/typo3 scheduler:list

vendor/bin/typo3 scheduler:run --task=<taskUid> --stop

# Find the id of the task
typo3/sysext/core/bin/typo3 scheduler:list

typo3/sysext/core/bin/typo3 scheduler:run --task=<taskUid> --stop

How to handle a truly "hung" task 

If a task hangs or is stuck (for example due to an infinite loop or external I/O), then stopping it via TYPO3 (either UI or CLI) will only clear TYPO3’s internal flag.

The actual PHP process running the task will continue on the system until it finishes or the OS/PHP process manager kills it.

If a task keeps running indefinitely:

#. Identify the process PID You can find the hanging PHP process using tools like top, ps aux | grep scheduler, or via systemctl status if you run TYPO3 via a systemd service. #. Manually terminate the PHP process (for example, kill <pid>). #. Clear the TYPO3 execution flag by running: vendor/bin/typo3 scheduler:run --task=<taskUid> --stop

ps aux | grep scheduler

# you might find something like this:
www-data  12345  99.0  5.2  php vendor/bin/typo3 scheduler:run

# To force-stop that OS-level process:
sudo kill 12345

# Then clear the mark again via:
vendor/bin/typo3 scheduler:run --task=13 --stop

Manually executing a task from the console 

# Note the id of the task
vendor/bin/typo3 scheduler:list

vendor/bin/typo3 scheduler:execute --task=<taskUid>

# Find the id of the task
typo3/sysext/core/bin/typo3 scheduler:list

typo3/sysext/core/bin/typo3 scheduler:execute --task=<taskUid>

Running the scheduler 

The command typo3 scheduler:run is usually called by the cron job.

It looks for tasks that are due, and runs them. You can optionally target specific task IDs, force them even if not due, or stop them.

vendor/bin/typo3 scheduler:run

typo3/sysext/core/bin/typo3 scheduler:run

Executing scheduler tasks 

The command typo3 scheduler:execute is a "manual fire" runner. You pick tasks (IDs or whole groups) and it executes them on demand, regardless of whether they are due. It can also prompt you interactively to choose.

# Note the id of the task
vendor/bin/typo3 scheduler:list

vendor/bin/typo3 scheduler:execute --task=<taskUid>

# Find the id of the task
typo3/sysext/core/bin/typo3 scheduler:list

typo3/sysext/core/bin/typo3 scheduler:execute --task=<taskUid>

Listing all scheduler tasks 

Command typo3 scheduler:list can be used to list all available tasks. This command basically displays the same information as the backend module Administration > Scheduler.

vendor/bin/typo3 scheduler:list

typo3/sysext/core/bin/typo3 scheduler:list

Show help 

In order to show help:

vendor/bin/typo3 scheduler:run --help

typo3/sysext/core/bin/typo3 scheduler:run --help

Providing options to the shell script 

The shell scripts accepts a number of options which can be provided in any order.

# Run task with uid 42
vendor/bin/typo3 scheduler:run --task=42

# Run tasks with uid 3 and 14
vendor/bin/typo3 scheduler:run --task=3 --task=14

# Run task with uid 42
typo3/sysext/core/bin/typo3 scheduler:run --task=42

# Run tasks with uid 3 and 14
typo3/sysext/core/bin/typo3 scheduler:run --task=3 --task=14

# Run task with uid 42, even if disabled
vendor/bin/typo3 scheduler:run --task=42 --force

# Run task with uid 42, even if disabled
typo3/sysext/core/bin/typo3 scheduler:run --task=42 --force

# Run task with uid 42, with detailed stack traces
vendor/bin/typo3 scheduler:run --task=42 -vv

# Run task with uid 42, with detailed stack traces
typo3/sysext/core/bin/typo3 scheduler:run --task=42 -vv

Implementation of a custom scheduler task 

All scheduler task implementations must extend \TYPO3\CMS\Scheduler\Task\AbstractTask .

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\Task;

use MyVendor\MyExtension\BusinessLogic;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Scheduler\Task\AbstractTask;

final class MyTask extends AbstractTask
{
    /**
     * MUST be implemented by all tasks
     */
    public function execute(): bool
    {
        # Dependency injection cannot be used in scheduler tasks
        $businessLogic = GeneralUtility::makeInstance(BusinessLogic::class);
        return $businessLogic->run('arg1', 'arg2', '…');
    }

    public function getAdditionalInformation()
    {
        $this->getLanguageService()->sL('LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:myTaskInformation');
    }
}

A custom task implementation must override the method execute(): bool. It is the main method that is called when a task is executed. This method Should return true on successful execution, false on error.

Method getAdditionalInformation() should be implemented to provide additional information in the schedulers backend module.

Scheduler task implementations that provide additional fields should implement additional methods, expecially getTaskParameters().

Scheduler task registration and configuration 

Custom scheduler tasks can be registered via TCA overrides, for example in EXT:my_extension/Configuration/TCA/Overrides/tx_scheduler_my_task.php

<?php

declare(strict_types=1);

use MyVendor\MyExtension\Task\MyTask;
use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;

defined('TYPO3') or die();

if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
    ExtensionManagementUtility::addRecordType(
        [
            'label' => 'My Custom Task',
            'description' => 'Description of what this task does',
            'value' => MyTask::class,
            'icon' => 'my-custom-icon',
            'iconOverlay' => 'content-clock',
            'group' => 'my_extension',
        ],
        $GLOBALS['TCA']['tx_scheduler_task']['types']['0']['showitem'],
        [],
        '',
        'tx_scheduler_task'
    );
}

Providing additional fields for scheduler task 

Additional fields for scheduler tasks are handled via FormEngine and can be configured via TCA.

If the task should provide additional fields for configuration options in the backend module, you need to implement a second class, extending AbstractAdditionalFieldProvider .

The task needs to be registered via TCA override:

<?php

declare(strict_types=1);

use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;
use MyVendor\MyExtension\Task\MyTask;

defined('TYPO3') or die();

if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
    // Add custom fields to the tx_scheduler_task table
    ExtensionManagementUtility::addTCAcolumns(
        'tx_scheduler_task',
        [
            'my_extension_field' => [
                'label' => 'LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:field.label',
                'config' => [
                    'type' => 'input',
                    'size' => 30,
                    'required' => true,
                    'eval' => 'trim',
                    'placeholder' => 'Enter value here...',
                ],
            ],
            'my_extension_email_list' => [
                'label' => 'LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:emailList.label',
                'config' => [
                    'type' => 'text',
                    'rows' => 3,
                    'required' => true,
                    'placeholder' => 'admin@example.com',
                ],
            ],
        ]
    );

    // Register the task type
    ExtensionManagementUtility::addRecordType(
        [
            'label' => 'Some title or LLL:EXT reference',
            'description' => 'Some description or LLL:EXT reference',
            'value' => MyTask::class,
            'icon' => 'mimetypes-x-tx_scheduler_task_group',
            'iconOverlay' => 'content-clock',
            'group' => 'my_extension',
        ],
        '
            --div--;core.form.tabs:general,
                tasktype,
                task_group,
                description,
                my_extension_field,
                my_extension_email_list,
            --div--;core.form.tabs:timing,
                execution_details,
                nextexecution,
                --palette--;;lastexecution,
            --div--;core.form.tabs:access,
                disable,
            --div--;core.form.tabs:extended,',
        [],
        '',
        'tx_scheduler_task'
    );
}

And implemented the following methods in your scheduler task if needed:

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\Task;

use MyVendor\MyExtension\BusinessLogic;
use TYPO3\CMS\Core\Messaging\FlashMessage;
use TYPO3\CMS\Core\Messaging\FlashMessageService;
use TYPO3\CMS\Core\Type\ContextualFeedbackSeverity;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Scheduler\Task\AbstractTask;

final class MyTask extends AbstractTask
{
    protected string $myField = '';
    protected string $emailList = '';

    public function execute(): bool
    {
        # Dependency injection cannot be used in scheduler tasks
        $businessLogic = GeneralUtility::makeInstance(BusinessLogic::class);
        return $businessLogic->run($this->myField, $this->emailList, '…');
    }

    /**
     * Set field values from associative array.
     *
     * @param array $parameters Values from TCA fields
     */
    public function setTaskParameters(array $parameters): void
    {
        $this->myField = $parameters['my_extension_field'] ?? '';
        $this->emailList = $parameters['my_extension_email_list'] ?? '';
    }

    /**
     * Validate task parameters.
     * Only implement this method for validation that cannot be handled by FormEngine.
     * Basic validation like 'required' should be done via TCA 'eval' configuration.
     */
    public function validateTaskParameters(array $parameters): bool
    {
        $isValid = true;

        // Example: Custom email validation (beyond basic 'required' check)
        $emailList = $parameters['my_extension_email_list'] ?? '';
        if (!empty($emailList)) {
            $emails = GeneralUtility::trimExplode(',', $emailList, true);
            foreach ($emails as $email) {
                if (!GeneralUtility::validEmail($email)) {
                    GeneralUtility::makeInstance(FlashMessageService::class)
                        ->getMessageQueueByIdentifier()
                        ->addMessage(
                            GeneralUtility::makeInstance(
                                FlashMessage::class,
                                'Invalid email address: ' . $email,
                                '',
                                ContextualFeedbackSeverity::ERROR
                            )
                        );
                    $isValid = false;
                }
            }
        }

        return $isValid;
    }
    public function getAdditionalInformation(): string
    {
        return sprintf(
            'Field: %s, Emails: %s',
            $this->myField,
            $this->emailList
        );
    }
}

Migrating tasks with AdditionalFieldProviders to TCA registration 

Scheduler tasks should now be registered as native task types using TCA. This provides a more integrated and maintainable approach to task configuration.

<?php

declare(strict_types=1);

use MyVendor\MyExtension\Task\MyTask;

if ((new \TYPO3\CMS\Core\Information\Typo3Version())->getMajorVersion() < 14) {
    // Todo: Remove when TYPO3 13 support is dropped
    $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['scheduler']['tasks'][MyTask::class] = [
        'extension' => 'my_extension',
        'title' => 'LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:myTask.title',
        'description' => 'LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:myTask.description',
        'additionalFields' => \MyVendor\MyExtension\Task\MyTaskAdditionalFieldProvider::class,
    ];
}

<?php

declare(strict_types=1);

use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;
use MyVendor\MyExtension\Task\MyTask;

defined('TYPO3') or die();

if (isset($GLOBALS['TCA']['tx_scheduler_task'])) {
    // Add custom fields to the tx_scheduler_task table
    ExtensionManagementUtility::addTCAcolumns(
        'tx_scheduler_task',
        [
            'my_extension_field' => [
                'label' => 'LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:field.label',
                'config' => [
                    'type' => 'input',
                    'size' => 30,
                    'required' => true,
                    'eval' => 'trim',
                    'placeholder' => 'Enter value here...',
                ],
            ],
            'my_extension_email_list' => [
                'label' => 'LLL:EXT:my_extension/Resources/Private/Language/locallang.xlf:emailList.label',
                'config' => [
                    'type' => 'text',
                    'rows' => 3,
                    'required' => true,
                    'placeholder' => 'admin@example.com',
                ],
            ],
        ]
    );

    // Register the task type
    ExtensionManagementUtility::addRecordType(
        [
            'label' => 'Some title or LLL:EXT reference',
            'description' => 'Some description or LLL:EXT reference',
            'value' => MyTask::class,
            'icon' => 'mimetypes-x-tx_scheduler_task_group',
            'iconOverlay' => 'content-clock',
            'group' => 'my_extension',
        ],
        '
            --div--;core.form.tabs:general,
                tasktype,
                task_group,
                description,
                my_extension_field,
                my_extension_email_list,
            --div--;core.form.tabs:timing,
                execution_details,
                nextexecution,
                --palette--;;lastexecution,
            --div--;core.form.tabs:access,
                disable,
            --div--;core.form.tabs:extended,',
        [],
        '',
        'tx_scheduler_task'
    );
}

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\Task;

use MyVendor\MyExtension\BusinessLogic;
use TYPO3\CMS\Core\Messaging\FlashMessage;
use TYPO3\CMS\Core\Messaging\FlashMessageService;
use TYPO3\CMS\Core\Type\ContextualFeedbackSeverity;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Scheduler\Task\AbstractTask;

final class MyTask extends AbstractTask
{
    protected string $myField = '';
    protected string $emailList = '';


    public function execute(): bool
    {
        # Dependency injection cannot be used in scheduler tasks
        $businessLogic = GeneralUtility::makeInstance(BusinessLogic::class);
        return $businessLogic->run($this->myField, $this->emailList, '…');
    }

    /**
     * Return current field values as associative array.
     * This method is called during migration from old serialized tasks
     * and when displaying task information.
     */
    public function getTaskParameters(): array
    {
        return [
            'my_extension_field' => $this->myField,
            'my_extension_email_list' => $this->emailList,
        ];
    }
    /**
     * Set field values from associative array.
     * This method handles both old and new parameter formats for migration.
     *
     * @param array $parameters Values from either old AdditionalFieldProvider or new TCA fields
     */
    public function setTaskParameters(array $parameters): void
    {
        // Handle migration: check old parameter names first, then new TCA field names
        $this->myField = $parameters['myField'] ?? $parameters['my_extension_field'] ?? '';
        $this->emailList = $parameters['emailList'] ?? $parameters['my_extension_email_list'] ?? '';
    }

    /**
     * Validate task parameters.
     * Only implement this method for validation that cannot be handled by FormEngine.
     * Basic validation like 'required' should be done via TCA 'eval' configuration.
     */
    public function validateTaskParameters(array $parameters): bool
    {
        $isValid = true;

        // Example: Custom email validation (beyond basic 'required' check)
        $emailList = $parameters['my_extension_email_list'] ?? '';
        if (!empty($emailList)) {
            $emails = GeneralUtility::trimExplode(',', $emailList, true);
            foreach ($emails as $email) {
                if (!GeneralUtility::validEmail($email)) {
                    GeneralUtility::makeInstance(FlashMessageService::class)
                        ->getMessageQueueByIdentifier()
                        ->addMessage(
                            GeneralUtility::makeInstance(
                                FlashMessage::class,
                                'Invalid email address: ' . $email,
                                '',
                                ContextualFeedbackSeverity::ERROR
                            )
                        );
                    $isValid = false;
                }
            }
        }

        return $isValid;
    }
    public function getAdditionalInformation(): string
    {
        $info = [];
        if ($this->myField !== '') {
            $info[] = 'Field: ' . $this->myField;
        }
        if ($this->emailList !== '') {
            $info[] = 'Emails: ' . $this->emailList;
        }
        return implode(', ', $info);
    }

    /**
     * is called by additional field provider
     * Todo: Remove setters once TYPO3 13 support is dropped
     * @deprecated
     */
    public function setMyField(string $myField): void
    {
        $this->myField = $myField;
    }

    /**
     * is called by additional field provider
     * Todo: Remove setters once TYPO3 13 support is dropped
     * @deprecated
     */
    public function setEmailList(string $emailList): void
    {
        $this->emailList = $emailList;
    }

}

ModifyNewSchedulerTaskWizardItemsEvent 

The PSR-14 event \TYPO3\CMS\Scheduler\Event\ModifyNewSchedulerTaskWizardItemsEvent allows extensions to modify the items in the scheduler task wizard.

AfterTaskExecutionEvent 

The PSR-14 event \TYPO3\CMS\Scheduler\Event\AfterTaskExecutionEvent is dispatched after a scheduled task (including command tasks) has been executed. It provides the following information:

• getTask(): AbstractTask — the executed task object
• isSuccess(): bool — whether the task completed without exception
• getException(): ?\Throwable — the thrown exception on failure, or null on success

Example listener:

use TYPO3\CMS\Scheduler\Event\AfterTaskExecutionEvent;

final class SchedulerTaskResultListener
{
    public function __invoke(AfterTaskExecutionEvent $event): void
    {
        $task = $event->getTask();
        $status = $event->isSuccess() ? 'success' : 'failure';
        // e.g. send a notification, write to a custom log, etc.
    }
}

tx_scheduler_task fields 

The database table tx_scheduler_task contains the following fields:

tasktype

Typically contains the fully qualified class name of the task, for example \TYPO3\CMS\Scheduler\Task\CachingFrameworkGarbageCollectionTask or the command name, for example language:update if the task is implemented as Symfony console command.

parameters

The options configuring the task as JSON-encoded value.

execution_details

Contains all details on execution like the type (Recurring / Single), start and end dates and the frequency in which recurring tasks should be executed.

Additionally it stores some information on the last and next execution of the task, and fields for a description and the group.

Migration from serialized task objects