README

Database-driven cronjob manager for Laravel. Store jobs in MySQL, schedule each one with its own cron expression, retry/timeout policy, and dispatch them to the queue. Ships with a React admin UI.

Requirements

PHP ^8.2
Laravel ^12.0
A running schedule:work process (so pending jobs get dispatched every minute).
A queue worker (queue:work / queue:listen) if you want jobs to actually run off the main process.

Installation

composer require sefirosweb/laravel-cronjobs:^12.0

The service provider auto-registers via Laravel's package discovery.

Run migrations:

php artisan migrate

This creates the cronjobs table with fields for name, description, target controller/method, cron expression, backoff, max tries, timeout, retries, and soft-delete.

Configuration

Publish the config:

php artisan vendor:publish --provider="Sefirosweb\LaravelCronjobs\LaravelCronjobsServiceProvider" --tag=config --force

Default config/laravel-cronjobs.php:

return [
    'prefix'     => 'cronjobs',
    'middleware' => 'web',
];

⚠️ Security: the admin UI can dispatch any controller/method in your app. Always protect it with auth and an ACL check. If you use sefirosweb/laravel-access-list:
return [
    'prefix'     => 'cronjobs',
    'middleware' => ['web', 'auth', 'checkAcl:cronjobs_edit'],
];

Publish the React admin UI assets:

php artisan vendor:publish --provider="Sefirosweb\LaravelCronjobs\LaravelCronjobsServiceProvider" --tag=cronjobs-assets --force

Usage

1. Keep the scheduler running

The service provider registers a cronjobs:pending command on Laravel's scheduler to run every minute. You need Laravel's own scheduler process alive:

php artisan schedule:work

…and a queue worker (recommended):

php artisan queue:work

2. Add and manage cronjobs from the UI

Browse to /cronjobs (or whatever prefix you configured). For each job you define:

Field	Meaning
Name	Free text identifier (unique).
Description	Free text.
Controller	Fully qualified class, e.g. `App\Http\Controllers\Admin\ReportsController`.
Function	Public method with no required parameters.
Cron expression	Standard cron syntax, e.g. `0 3 * * *`. The UI shows a preview of the next 40 runs.
Backoff	Seconds to wait before retrying after failure.
Max tries	Number of retry attempts before marking the job as failed.
Timeout	Seconds before the worker kills the job.

3. Listen for events

Each dispatch emits an event that your app can react to:

use Sefirosweb\LaravelCronjobs\Events\DispatchCronjobSuccessfully;
use Sefirosweb\LaravelCronjobs\Events\DispatchCronjobError;

Event::listen(DispatchCronjobSuccessfully::class, function ($e) {
    // $e->cronjob
});

Event::listen(DispatchCronjobError::class, function ($e) {
    // $e->cronjob, $e->error
});

4. Artisan commands

# List all cronjobs (active + trashed)
php artisan cronjobs:list

# Manually run a job by name
php artisan cronjobs:execute "Send invoices"

# Run all currently due jobs (this is what the scheduler calls internally)
php artisan cronjobs:pending

Testing

composer install
./vendor/bin/phpunit

The suite uses Orchestra Testbench + SQLite :memory: and covers controller CRUD, the DispatchCronjob job, the Cronjob model (soft-deletes, casts), and the Carbon 3 diffInSeconds regression fix.

When working from the laravel-test harness with Sail:

docker exec -w /var/www/html/packages/laravel-cronjobs laravel-test-laravel.test-1 ./vendor/bin/phpunit

Versioning

Major versions are aligned with Laravel majors (12.x, 11.x, 9.x …). See the root CLAUDE.md of the test harness for the full policy.

License

MIT.

sefirosweb / laravel-cronjobs

Maintainers

Package info

Statistics

Security