Laravel
Planowanie zadań

Tworzenie zadania

Możesz utworzyć zadanie (polecenie konsoli) w Laravel za pomocą Artisan. Z linii poleceń:

php artisan make:console MyTaskName

Spowoduje to utworzenie pliku w app / Console / Commands / MyTaskName.php . Będzie to wyglądać tak:

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;

class MyTaskName extends Command
{
    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'command:name';

    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = 'Command description';

    /**
     * Create a new command instance.
     *
     * @return void
     */
    public function __construct()
    {
        parent::__construct();
    }

    /**
     * Execute the console command.
     *
     * @return mixed
     */
    public function handle()
    {
        //
    }
}

Niektóre ważne części tej definicji to:

• Właściwość $signature identyfikuje twoje polecenie. Będziesz mógł wykonać to polecenie później za pomocą wiersza poleceń za pomocą Artisan, uruchamiając php artisan command:name (gdzie command:name pasuje do $signature polecenia)
• Właściwość $description jest wyświetlaniem pomocy / użycia Artisan obok polecenia, gdy jest ono dostępne.
• Metoda handle() służy do pisania kodu dla polecenia.

Ostatecznie twoje zadanie zostanie udostępnione w linii poleceń za pośrednictwem Artisan. protected $signature = 'command:name'; właściwość tej klasy jest tym, czego byś użył do jej uruchomienia.

Udostępnianie zadania

Możesz udostępnić zadanie Artisanowi i swojej aplikacji w pliku app / Console / Kernel.php .

Klasa Kernel zawiera tablicę o nazwie $commands która udostępnia twoje polecenia aplikacji.

Dodaj swoje polecenie do tej tablicy, aby udostępnić je Artisan i aplikacji.

<?php

namespace App\Console;

use Illuminate\Console\Scheduling\Schedule;
use Illuminate\Foundation\Console\Kernel as ConsoleKernel;

class Kernel extends ConsoleKernel
{
    /**
     * The Artisan commands provided by your application.
     *
     * @var array
     */
    protected $commands = [
        Commands\Inspire::class,
        Commands\MyTaskName::class // This line makes MyTaskName available
    ];

    /**
     * Define the application's command schedule.
     *
     * @param  \Illuminate\Console\Scheduling\Schedule  $schedule
     * @return void
     */
    protected function schedule(Schedule $schedule)
    {
    
    }
}

Gdy to zrobisz, możesz teraz uzyskać dostęp do swojego polecenia za pomocą wiersza poleceń, używając Artisan. Zakładając, że twoje polecenie ma właściwość $signature ustawione na my:task , możesz uruchomić następujące polecenie, aby wykonać swoje zadanie:

php artisan my:task

Zaplanuj swoje zadanie

Gdy twoje polecenie zostanie udostępnione twojej aplikacji, możesz użyć Laravela, aby zaplanować jego uruchamianie we wcześniej określonych odstępach czasu, podobnie jak CRON.

W pliku app / Console / Kernel.php znajdziesz metodę schedule , której możesz użyć do zaplanowania zadania.

<?php

namespace App\Console;

use Illuminate\Console\Scheduling\Schedule;
use Illuminate\Foundation\Console\Kernel as ConsoleKernel;

class Kernel extends ConsoleKernel
{
    /**
     * The Artisan commands provided by your application.
     *
     * @var array
     */
    protected $commands = [
        Commands\Inspire::class,
        Commands\MyTaskName::class
    ];

    /**
     * Define the application's command schedule.
     *
     * @param  \Illuminate\Console\Scheduling\Schedule  $schedule
     * @return void
     */
    protected function schedule(Schedule $schedule)
    {
        $schedule->command('my:task')->everyMinute();
        // $schedule->command('my:task')->everyFiveMinutes();
        // $schedule->command('my:task')->daily();
        // $schedule->command('my:task')->monthly();
        // $schedule->command('my:task')->sundays();
    }
}

Zakładając, że $signature zadania jest my:task można zaplanować w sposób pokazany powyżej, korzystając z obiektu Schedule $schedule . Laravel zapewnia wiele różnych sposobów planowania polecenia, jak pokazano w komentarzach powyżej.

Ustawianie harmonogramu do uruchomienia

Program planujący można uruchomić za pomocą polecenia:

php artisan schedule:run

Harmonogram musi być uruchamiany co minutę, aby działał poprawnie. Możesz to ustawić, tworząc zadanie cron z następującym wierszem, który uruchamia program planujący co minutę w tle.

* * * * * php /path/to/artisan schedule:run >> /dev/null 2>&1