Laravel 5 Package Scheduled Tasks
You certainly can, all through the power of some basic object-oriented programming!
Step 1: Create Your Package's "Kernel" Console Class
Let's create a Kernal class within your package's Console directory where we will be extending App\Console\Kernel
.
<?php
namespace Acme\Package\Console;
use App\Console\Kernel as ConsoleKernel;
use Illuminate\Console\Scheduling\Schedule;
class Kernel extends ConsoleKernel
{
//
}
Step 2: Add the schedule
method
Since we are extending the App Console Kernel, we'll want to add the relevant schedule method and call the parent class' implementation of it. This will ensure that any previously scheduled tasks carry through.
<?php
namespace Acme\Package\Console;
use App\Console\Kernel as ConsoleKernel;
use Illuminate\Console\Scheduling\Schedule;
class Kernel extends ConsoleKernel
{
/**
* Define the package's command schedule.
*
* @param \Illuminate\Console\Scheduling\Schedule $schedule
* @return void
*/
protected function schedule(Schedule $schedule)
{
parent::schedule($schedule);
//
}
}
Step 3: Add your scheduled tasks
Now you may add your own scheduled tasks per normal.
$schedule->command('')->daily();
Step 4: Register It!
We'll want to bind the class to the container, and make
it within our package's service provider's register
method:
$this->app->singleton('acme.package.console.kernel', function($app) {
$dispatcher = $app->make(\Illuminate\Contracts\Events\Dispatcher::class);
return new \Acme\Package\Console\Kernel($app, $dispatcher);
});
$this->app->make('acme.package.console.kernel');
That should be all that's required!
Some things to take into consideration with this though:
- Be up-front that your package has these bundled tasks. Developers don't like surprises (especially when it concerns tasks being automatically ran on their server).
- Along with the first point, not every one will have the required cronjob set up on their server. They'll need to do this before your package's tasks will run automatically.
- Provide a config option to disable the package's tasks from being auto registered, and documentation on how developers can register it themselves based on their own needs.