bearframework/tasks-addon

Tasks addon for Bear Framework

v1.6.0 2025-12-06 22:41 UTC

Requires

• php: 8.0.*|8.1.*|8.2.*|8.3.*|8.4.*|8.5.*
• bearframework/bearframework: 1.*
• ivopetkov/locks-bearframework-addon: 1.*

Requires (Dev)

• bearframework/addon-tests: 1.*

MIT

• Ivo Petkov

• addon
• Tasks
• scheduler
• bear framework

README

A lightweight task scheduling and execution addon for Bear Framework. It lets you register task handlers, enqueue work items with scheduling and priority options, and process them via a runnable worker.

Snippets

Define task (register handler)

$app->tasks
    ->define('definition-id', function ($value): void {
        // code
    })

Add task

$app->tasks
    ->add('definition-id', 'example-value', [
        'id' => 'task-id', // optional
        'listID' => '', // empty value for the default list
        'startTime' => time() + 120, // start in 2 minutes
        'priority' => 3, // 1 - lowest, 5 - highest
        'ignoreIfExists' => true, // will check the id only
    ]);

Run tasks

$app->tasks
    ->addEventListener('runTask', function (\BearFramework\Tasks\RunTaskEventDetails $eventDetails) use ($app) {
        $app->logs->log('run-task', $eventDetails->definitionID);
    })
    ->run([
        'listID' => '',
        'maxExecutionTime' => 30
    ]);

Contributing

Contributions and bug reports are welcome. Open issues or submit pull requests to the repository.

License

This addon is free to use under the MIT license. See the LICENSE file for details.