README

Queues for the CodeIgniter 4 framework.

Note

A queue system is typically used to handle resource-intensive or time-consuming tasks (e.g., image processing, sending emails) that are to be run in the background. It can also be a way to postpone certain activities that are to be executed automatically later.

Installation

composer require codeigniter4/queue

Migrate your database:

php spark migrate --all

Configuration

Publish configuration file:

php spark queue:publish

Create your first Job:

php spark queue:job Example

Add it to the $jobHandlers array in the app\Config\Queue.php file:

// ...

use App\Jobs\Example;

// ...

public array $jobHandlers = [
    'my-example' => Example::class
];

// ...

Basic usage

Add job to the queue:

service('queue')->push('queueName', 'my-example', ['data' => 'array']);

Run the queue worker:

php spark queue:work queueName

Docs

Read the full documentation: https://queue.codeigniter.com

Contributing

We accept and encourage contributions from the community in any shape. It doesn't matter whether you can code, write documentation, or help find bugs, all contributions are welcome. See the CONTRIBUTING.md file for details.