Scheduled task to run every month

Hi there,

I'm trying to create a scheduled task that runs once a month.

Not much is documented on it, so I'm trying to do some digging.

Here's what I got. So I extended/register the scheduler like bellow

    (new Extend\Console())
        ->schedule(\M\MyExtension\Console\InitCommand::class, function (Event $event) {
            $event->monthly();
        } )

And then the command.

class InitCommand extends Command{

    protected $signature = '???';
    protected $description = 'Description of the command';

    public function handle ()
    {
        //... code
    }

}

Trying to understand how to structure it. This is pretty much from what I've seen in other examples. But I'm not entirely sure what this does and how this works.

So the Console and the schedule method register the scheduler with the event->monthly() telling the scheduler this is something to run 1st of every month?

And the command class is the logic that is triggered by the scheduler? Is my understanding correct that the command class is where the logic I want to run should live?

luceos Thanks!

Reading into this, are the Artisan Commands more for Artisan CLI commands you want the scheduler to fire?

So, is this a correct way of viewing this?
Commands - Artisan CLI commands to run
Jobs - Class with logic to run that's added to the queue
Invokable objects - Class with logic to run that gets executed directly

luceos Ah, thanks!.. That makes sense.

So I did some reading on it. Looking at the scheduler, it expects a command class, but how do I use a invokable class instead?

I tried putting my invokable class in the first argument, but that didn't work. I could probably use the invokable class to replace the function in the second argument (like i've seen in another example), but the invokable class I also want to use in another place in the codebase that's not scheduled (that's meant to be triggered manually).

So would the syntax look something like this?

 (new Extend\Console())
        ->schedule(CommandClass::class, function (Event $event) {
            $invokable = new MyInvokableClass()
            $invokable('myArg')

            $event->monthly();
        } )

Is the command class in the first argument needed? Or could I pass null as a parameter?

luceos (new Extend\Console())
->schedule(new MyInvokableClass('myArg'), function (Event $event) {
$event->monthly();
})

Tried this but I'm getting the error: TypeError: Flarum\Extend\Console::schedule(): Argument #1 ($command) must be of type string

luceos (new Extend\Console())
->schedule(MyInvokableClass::class, function (Event $event) {
$event->monthly();
})

Also tried this without arg and then I get Error: Call to undefined method M\MyExtension\Tasks\MyInvokableClass::getName()

my class is just a simple class with the __invoke() method.

class MyInvokableClass {
   public function __invoke() {
      //...code
   }

}

Does it need to extend something in particular, like Illuminate\Console\Command?

luceos Thanks!

So I followed the documentation, I created a command class that extended \Flarum\Console\AbstractCommand.

So I got it to work. My solution was:

(new Extend\Console())
        ->command(MyCommandClass::class)
        ->schedule('my_command:init', function (Event $event) {
            $event->everyMinute();
        }, ['myArg'])

And my command class

class MyCommandClass extends AbstractCommand {
   protected function configure() {
      $this->setName('my_command:init')
      ->setDescription('do stuff')
      ->addArgument('myArg')
   }

   protected function fire() {
      //... my logic
   }
}

So even if Laravel support different types of scheduled tasks/classes. From my understanding, Flarum only supports running command classes. Could this be correct?

luceos I see. Are there any benefits/differences to using the Laravel command instead of Flarum's command?

luceos Ah ok. Thanks!