spatie / laravel-short-schedule
Schedule artisan commands to run using a sub-minute frequency
Fund package maintenance!
spatie
spatie.be/open-source/support-us
Installs: 845 092
Dependents: 2
Suggesters: 0
Security: 0
Stars: 612
Watchers: 8
Forks: 51
Open Issues: 0
Requires
- php: ^8.2
- illuminate/cache: ^10|^11.0
- react/event-loop: ^1.5
- spatie/laravel-package-tools: ^1.16.4
- spatie/temporary-directory: ^2.2.1
Requires (Dev)
- mockery/mockery: ^1.6.11
- orchestra/testbench: ^8.0|^9.0.3
- phpunit/phpunit: ^10.5.15
- spatie/test-time: ^1.3.3
README
Note
As the Laravel Scheduler now supports sub-minute scheduled tasks, this package is no longer needed.
Schedule artisan commands to run at a sub-minute frequency
Laravel's native scheduler allows you to schedule Artisan commands to run every minute.
If you need to execute something with a higher frequency, for example every second, than you've come to the right package. With laravel-short-schedule installed, you can do this:
// in your routes/console.php file use Spatie\ShortSchedule\Facades\ShortSchedule; // this command will run every second ShortSchedule::command('artisan-command')->everySecond(); // this command will run every 30 seconds ShortSchedule::command('another-artisan-command')->everySeconds(30); // this command will run every half a second ShortSchedule::command('another-artisan-command')->everySeconds(0.5);
Alternatively, you could add this to the shortSchedule
method in your console kernel:
// in app\Console\Kernel.php protected function shortSchedule(\Spatie\ShortSchedule\ShortSchedule $shortSchedule) { // this command will run every second $shortSchedule->command('artisan-command')->everySecond(); // this command will run every 30 seconds $shortSchedule->command('another-artisan-command')->everySeconds(30); // this command will run every half a second $shortSchedule->command('another-artisan-command')->everySeconds(0.5); // this command will run every second and its signature will be retrieved from command automatically $shortSchedule->command(\Spatie\ShortSchedule\Tests\Unit\TestCommand::class)->everySecond(); }
Are you a visual learner?
In this video you'll see a demonstration of the package.
Want to know how it works under the hood? Then watch this video.
Finally, there's this video that shows how the package is tested. You'll learn how you can test ReactPHP powered loops.
These videos are also part of the Laravel Package Training.
Support us
We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.
We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.
Installation
You can install the package via composer:
composer require spatie/laravel-short-schedule
In your production environment you can start the short scheduler with this command
php artisan short-schedule:run
You should use a process monitor like Supervisor to keep this task going at all times, and to automatically start it when your server boots. Whenever you change the schedule, you should restart this command.
Handle memory leaks
To deal with commands that leak memory, you can set the lifetime in seconds of the short schedule worker:
php artisan short-schedule:run --lifetime=60 // after 1 minute the worker will be terminated
After the given amount of seconds, the worker and all it's child processes will be terminated, freeing all memory. Then supervisor (or similar watcher) will bring it back.
Lumen
Before you can run the php artisan short-schedule:run
command in your Lumen project, you should make a copy of the ShortScheduleRunCommand
into your app/Commands
folder:
cp ./vendor/spatie/laravel-short-schedule/src/Commands/ShortScheduleRunCommand.php ./app/Console/Commands/ShortScheduleRunCommand.php
Next, edit the new ShortScheduleRunCommand.php
file, and change the namespace from namespace Spatie\ShortSchedule\Commands;
to namespace App\Console\Commands;
and you're good to go!
Usage
Un your routes/console.php file, you can use the ShortSchedule
facade to schedule commands.
// in your routes/console.php file use Spatie\ShortSchedule\Facades\ShortSchedule; ShortSchedule::command('artisan-command')->everySecond();
In app\Console\Kernel
you should add a method named shortSchedule
.
// in app\Console\Kernel.php protected function shortSchedule(\Spatie\ShortSchedule\ShortSchedule $shortSchedule) { // this artisan command will run every second $shortSchedule->command('artisan-command')->everySecond(); // this artisan command will run every second, its signature will be resolved from container $shortSchedule->command(\Spatie\ShortSchedule\Tests\Unit\TestCommand::class)->everySecond(); }
Specify the amount of seconds
You can run an artisan command every single second like this:
ShortSchedule::command('artisan-command')->everySecond();
You can specify a specific amount of seconds using everySeconds
ShortSchedule::command('artisan-command')->everySeconds(30);
You can even schedule tasks at sub-second frequency. This task will run every half a second.
ShortSchedule::command('artisan-command')->everySeconds(0.5);
Scheduling shell commands
Use exec
to schedule a bash command.
ShortSchedule::exec('bash-command')->everySecond();
Preventing overlaps
By default, a scheduled command will run, even if the previous invocation is still running.
You can prevent that by tacking on withoutOverlapping
ShortSchedule::command('artisan-command')->everySecond()->withoutOverlapping();
Between time constraints
Limit the task to run between start and end times.
ShortSchedule::command('artisan-command')->between('09:00', '17:00')->everySecond();
It is safe use overflow days. In this example the command will run on every second between 21:00 and 01:00
ShortSchedule::command('artisan-command')->between('21:00', '01:00')->everySecond();
Truth test constraints
The command will run if the given closure return a truthy value. The closure will be evaluated at the same frequency the command is scheduled. So if you schedule the command to run every second, the given closure will also run every second.
ShortSchedule::command('artisan-command')->when(fn() => rand() %2)->everySecond();
Environment constraints
The command will only run on the given environment.
ShortSchedule::command('artisan-command')->environments('production')->everySecond();
You can also pass an array:
ShortSchedule::command('artisan-command')->environments(['staging', 'production'])->everySecond();
Composite constraints
You can use all constraints mentioned above at once. The command will only execute if all the used constraints pass.
ShortSchedule::command('artisan-command') ->between('09:00', '17:00') ->when($callable) ->everySecond();
Maintenance Mode
Commands won't run whilst Laravel is in maintenance mode. If you would like to force a command to run in maintenance mode you can use the runInMaintenanceMode
method.
ShortSchedule::command('artisan-command')->everySecond()->runInMaintenanceMode();
Running Tasks On One Server
Limit commands to only run on one server at a time.
ShortSchedule::command('artisan-command')->everySecond()->onOneServer();
Events
Executing any code when responding to these events is blocking. If your code takes a long time to execute, all short scheduled jobs will be delayed. We highly recommend to put any code you wish to execute in response to these events on a queue.
Spatie\ShortSchedule\Events\ShortScheduledTaskStarting
This event will be fired right before a task will be started. It has these public properties:
command
: the command string that will be executedprocess
: the instance ofSymfony\Component\Process\Process
that will be used to execute the command
Spatie\ShortSchedule\Events\ShortScheduledTaskStarted
This event will be fired right before a task has been started. It has these public properties:
command
: the command string that is being executedprocess
: the instance ofSymfony\Component\Process\Process
that is executing the command
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you've found a bug regarding security please mail security@spatie.be instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.