Laravel Task Scheduling

Dalam artikel ini kita akan belajar tentang schedule / penjadwalan pada laravel, saya akan berusaha sebisa mungkin untuk menjelaskan case ini agar Anda dapat mengerti dengan baik.

9 min read

Published on 22 Nov, 2022 (updated: 23 Nov, 2022)

Written by Irsyad A. Panjaitan

Fill in Laravel

ArticlesLaravel Task Scheduling

Dalam artikel ini kita akan belajar tentang schedule / penjadwalan pada laravel, saya akan berusaha sebisa mungkin untuk menjelaskan case ini agar Anda dapat mengerti dengan baik.

Instal Laravel

Kita akan mulai dari awal disini, sehingga kita akan lakukan dari yang pertama kali yaitu instalasi laravel nya, buka terminal Anda dan jalankan perintah berikut.

laravel new schedule
bashCopy

Jika Anda tidak bisa instal laravel menggunakan laravel cli, Anda bisa menggunakan composer seperti berikut ini:

composer create-project laravel/laravel schedule
bashCopy

Jika sudah, sekarang kita akan menjalankan perintah migrate, namun sebelum itu, pastikan dulu Anda sudah mempunyai database dan kemudian sesuaikan pada file .env.

/.env
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=schedule DB_USERNAME=root DB_PASSWORD=
envCopy

Setelah itu, mari kita lakukan migrate dengan menjalan perintah berikut.

php artisan migrate
bashCopy

Factories dan Seeders

Oia, sepertinya kita butuh data untuk itu. Oleh karena itu, mari kita lakukan itu dengan factory. By default, laravel akan membawa yang factory untuk User yang itu bisa dilihat di database/factories/UserFactory.php, dan jika kita buka file nya kurang lebih akan seperti ini:

database/factories/UserFactory.php
<?php namespace Database\Factories; use Illuminate\Database\Eloquent\Factories\Factory; use Illuminate\Support\Str; /** * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\User> */ class UserFactory extends Factory { public function definition(): array { return [ 'name' => fake()->name(), 'email' => fake()->unique()->safeEmail(), 'email_verified_at' => now(), 'password' => bcrypt('password'), 'remember_token' => Str::random(10), ]; } public function unverified(): static { return $this->state(fn (array $attributes) => [ 'email_verified_at' => null, ]); } }
phpCopy

Sebelum kita menjalankan nya, saya akan modifikasi dulu terlebih dahulu untuk field created_at and updated_at nya jadi random.

database/factories/UserFactory.php
public function definition(): array { return [ 'name' => fake()->name(), 'email' => fake()->unique()->safeEmail(), 'email_verified_at' => now(), 'password' => bcrypt('password'), 'remember_token' => Str::random(10), 'created_at' => $createdAt = collect([ now()->subMonth(2), now()->subMonth(1), now()->subWeek(2), now()->subWeek(1), now() ])->random(1)->first(), 'updated_at' => $createdAt, ]; }
phpCopy

Setalah itu, silakan hilangkan komentar factory pada file database/seeders/DatabaseSeeder.php.

database/seeders/DatabaseSeeder.php
<?php namespace Database\Seeders; use Illuminate\Database\Seeder; class DatabaseSeeder extends Seeder { public function run(): void { \App\Models\User::factory(30)->create(); // \App\Models\User::factory()->create([ // 'name' => 'Test User', // 'email' => '[email protected]', // ]); } }
phpCopy

Jika sudah, sekarang kita buka terminal kembali, dan sekarang kita akan menjalankan perintah untuk seeder nya seperti:

php artisan migrate:fresh --seed
bashCopy

Dan jika sudah, harusnya pada tabel users akan sudah terbuat user sampai 30 dengan masing-masing created_at dan updated_at berbeda. Untuk melihatnya Anda bisa langsung pergi ke tinker dengan menjalankan perintah berikut:

php artisan tinker
bashCopy

Dan kemudian pluck created_at nya seperti:

Psy Shell v0.11.9 (PHP 8.1.11 — cli) by Justin Hileman > App\Models\User::pluck('created_at');
bashCopy

Dan harusnya output yang keluar pastinya seperti berikut:

= Illuminate\Support\Collection {#4639 all: [ Illuminate\Support\Carbon @1669116509 {#4636 date: 2022-11-22 11:28:29.0 UTC (+00:00), }, Illuminate\Support\Carbon @1667906909 {#4635 date: 2022-11-08 11:28:29.0 UTC (+00:00), }, Illuminate\Support\Carbon @1668511709 {#4634 date: 2022-11-15 11:28:29.0 UTC (+00:00),
bashCopy

Perhatikan pada date nya, mereka sudah berbeda-beda jika Anda perhatikan baik-baik. Tetapi tidak cukup hanya itu, disini kita akan buat sampel bagaimana membuat schedule untuk menghapus pengguna yang tidak melakukan verifikasi email yang mana telah mendaftar 1/2 bulan lalu.

Make oleh karena itu, kita akan langsung directly dari tinker melakukan factory nya dengan state unverified yant telah di sediakan oleh laravel yaitu.

database/factories/UserFactory.php
public function unverified(): static { return $this->state(fn (array $attributes) => [ 'email_verified_at' => null, ]); }
phpCopy

Nah untuk itu, buka silakan masuk lagi ke tinker dengan menjalankan php artisan tinker, setelah itu lakukan perintah berikut.

> App\Models\User::factory(30)->unverified()->create();
bashCopy

Setelah itu, maka kita akan mempunyai total 60 pengguna, 30 yang verified dan 30 lagi tidak verified. Verified akan di lihat dari null nya field dari email_verified_at nya.

Sehingga sekarang, jika kita buat di tinker perintah:

> App\Models\User::whereNull('email_verified_at')->count(); = 30
bashCopy

Model Pruning

Yang paling pertama, mari kita buat pruning untuk tabel user ini, jadi kita akan melakukan penghapusan secara otomatis jika user tidak melakukan verifikasi selama 1/2 bulan misalnya.

Pertama sekali, untuk menggunakan pruning ini, kita harus memasukkan trait yang namanya Prunable. Untuk itu, buka model User.php dan tambahkan dia seperti:

app/Models/User.php
... use Illuminate\Database\Eloquent\Prunable; class User extends Authenticatable { use HasApiTokens, HasFactory, Notifiable, Prunable;
phpCopy

Setelah itu, kita akan menambahkan metode baru pada model ini dengan nama prunable seperti:

app/Models/User.php
class User extends Authenticatable { use HasApiTokens, HasFactory, Notifiable, Prunable; protected $fillable = ['name', 'email', 'password']; protected $hidden = ['password', 'remember_token']; protected $casts = ['email_verified_at' => 'datetime']; public function prunable() { return static::whereNull('email_verified_at') ->where('created_at', '<=', now() ->subMonth()); } }
phpCopy

Isi dari query tersebut adalah untuk memastikan kita akan mengapus user yang tidak verifikasi selama 1 bulan terakhir. Dan sekarang, Anda bisa buka file app/Console/Kernel.php untuk memasukkan schedule dengan menambahkan nya tepat di dalam methode schedule seperti:

app/Console/Kernel.php
class Kernel extends ConsoleKernel { protected function schedule(Schedule $schedule): void { $schedule->command('model:prune')->weekly(); // $schedule->command('inspire')->hourly(); } protected function commands(): void{...} }
phpCopy

Setelah itu, kita akan memeriksa apakah schedule itu sudah masuk atau belum di dalam tasklist nya dengan menjalankan perintah berikut:

php artisan schedule:list
bashCopy

Maka harusnya, output yang dihasilkan kurang lebih akan seperti ini:

0 0 * * 0 php artisan model:prune ........................ Next Due: 4 days from now
bashCopy

Nah, untuk menjalankannya, kita menggunakan perintah schedule:run seperti:

php artisan schedule:run
bashCopy

Dan harusnya, yang muncul adalah seperti:

INFO No scheduled commands are ready to run.
bashCopy

Arti dari info tersebut adalah tidak ada belum schedule yang mau di jalankan. Masuk akal memang, karena jika kita perhatikan tadi pada list schedule nya, itu akan di jalankan 4 hari lagi dari sekarang. Maka untuk itu, kita bisa modifikasi dia dengan cara mengganti weekly() dengan everyMinute() untuk contoh ini saja.

app/Console/Kernel.php
class Kernel extends ConsoleKernel { protected function schedule(Schedule $schedule): void { $schedule->command('model:prune')->everyMinute(); // $schedule->command('inspire')->hourly(); } protected function commands(): void{...} }
phpCopy

Pastinya jika ini di production, harusnya untuk case ini kita bisa jalankan sekali seminggu saja, namun untuk test saja, kita akan buat dia everyMinute agar kita yang mana telah di hapusnya.

Menjalankan Schedule di Lokal

Sekarang, untuk menjalankan schedule tersebut di background, kita bisa menggunakan perintah schedule:work seperti berikut:

php artisan schedule:work
bashCopy

Sekarang jika Anda lihat outputnya setelah 1 menit akan seperti berikut:

INFO Running schedule tasks every minute. 2022-11-22 11:55:00 Running ['artisan' model:prune] ............. 234ms DONE '/opt/homebrew/Cellar/php/8.1.11/bin/php' 'artisan' model:prune > '/dev/null' 2>&1
bashCopy

Dan perintah tersebut akan terus jalan setiap 1 menit. Maka nya sekarang di saya sudah 2 kali:

INFO Running schedule tasks every minute. 2022-11-22 11:55:00 Running ['artisan' model:prune] ............. 234ms DONE '/opt/homebrew/Cellar/php/8.1.11/bin/php' 'artisan' model:prune > '/dev/null' 2>&1 2022-11-22 11:56:00 Running ['artisan' model:prune] ............. 183ms DONE '/opt/homebrew/Cellar/php/8.1.11/bin/php' 'artisan' model:prune > '/dev/null' 2>&1
bashCopy

Anda bisa tekan ctrl+c untuk menghentikan perintahnya. Dan sekarang, mari kita kembali ke tinker untuk menjalakan perintah yang tadi yaitu melihat jumlah yang tidak verifikasi tinggal berapa:

php artisan tinker
bashCopy

Dan jalankan query seperti yang tadi:

User::whereNull('email_verified_at')->count() = 20
bashCopy

Karena tadi kita buat random, maka hasilnya harusnya beda dengan Anda, kalau di saya hasilnya 20 seperti yang Anda lihat di atas, mungkin Anda bisa saja entah berapa, karena tergantung field created_at yang telah dibuat factory tadi.

Pastinya Anda akan menggunakan php artisan schedule:run pada saat production mode.

Dalam artikel ini, kita hanya memperaktekkan everyMinute, namun sebenarnya itu terserah Anda. Seperti yang saya bilang, harusnya untuk case ini, biasa saya hanya melakukan weekly dari pada everyMinute, karena jika ini terus-terus di jalankan, beban pada server akan semakin besar.

Daftar Penjadwalan

Berikut ini adalah metode-metode yang bisa Anda gunakan untuk pilihan waktu menjalankannya.

MetodeDeskripsi
->cron('* * * * *');Menjalankan schedule dengan pilihan waktu sendiri
->everyMinute();Jalankan tugas setiap menit
->everyTwoMinutes();Jalankan tugas setiap dua menit
->everyThreeMinutes();Jalankan tugas setiap tiga menit
->everyFourMinutes();Jalankan tugas setiap empat menit
->everyFiveMinutes();Jalankan tugas setiap lima menit
->everyTenMinutes();Jalankan tugas setiap sepuluh menit
->everyFifteenMinutes();Jalankan tugas setiap lima belas menit
->everyThirtyMinutes();Jalankan tugas setiap tiga puluh menit
->hourly();Jalankan tugas setiap jam
->hourlyAt(17);Jalankan tugas setiap jam pada 17 menit lewat satu jam
->everyOddHour();Jalankan tugas setiap jam ganjil
->everyTwoHours();Jalankan tugas setiap dua jam
->everyThreeHours();Jalankan tugas setiap tiga jam
->everyFourHours();Jalankan tugas setiap empat jam
->everySixHours();Jalankan tugas setiap enam jam
->daily();Jalankan tugas setiap hari pada tengah malam
->dailyAt('13:00');Jalankan tugas setiap hari pukul 13:00
->twiceDaily(1, 13);Jalankan tugas setiap hari pada pukul 1:00 dan 13:00
->twiceDailyAt(1, 13, 15);Jalankan tugas setiap hari pada 1:15 & 13:15
->weekly();Jalankan tugas setiap hari Minggu pukul 00:00
->weeklyOn(1, '8:00');Jalankan tugas setiap minggu pada hari Senin pukul 8:00
->monthly();Jalankan tugas pada hari pertama setiap bulan pukul 00:00
->monthlyOn(4, '15:00');Jalankan tugas setiap bulan pada tanggal 4 pukul 15:00
->twiceMonthly(1, 16, '13:00');Jalankan tugas setiap bulan pada tanggal 1 dan 16 pukul 13:00
->lastDayOfMonth('15:00');Jalankan tugas pada hari terakhir bulan itu pukul 15:00
->quarterly();Jalankan tugas pada hari pertama setiap kuartal pukul 00:00
->quarterlyOn(4, '14:00');Jalankan tugas setiap kuartal pada tanggal 4 pukul 14:00
->yearly();Jalankan tugas pada hari pertama setiap tahun pukul 00:00
->yearlyOn(6, 1, '17:00');Jalankan tugas setiap tahun pada tanggal 1 Juni pukul 17:00
->timezone('America/New_York');Tetapkan zona waktu untuk tugas tersebut

Metode di atas itu semua dari dokumentasi yang sudah saya artikan ke bahasa.

Hati - Hati

Pastikan untuk command schedule nya sudah cocok dengan crontab nya. Jika kalian menggunakan model 1/2 jam seperti misalnya menjalankan 04:30, maka pastikan Anda juga sudah yakin bahwa crontab nya jalan setiap 30 menit.

$schedule->command('backup:run --only-db')->daily()->at('04.30');
phpCopy

Karena jika crontab jalan setiap 1 jam, maka schedule di atas tidak akan pernah jalan. Jadi pastikan Anda telah membuat sinkronisasi yang pasti antara crontab dan juga perintah schedule nya.

Penting Untuk Dipahami

Bayangkan jika kalian mempunyai beberapa tugas schedule, yang dari salah satunya itu mempunyai tugas yang sangat banyak dan lama.

By default, schedule akan menjalankan tergantung letak dari tugas yang di definisikan. Jadi jika kita punya tugas A,B,C dalam satu waktu, maka dia akan di order dari yang pertama.

Bayangkan jika B mempunyai tugas yang sangat lama, maka C akan terus menggu hingga B selesai, nah untuk itu, kita bisa menambahkan metode runInBackground setelah waktu yang di tentukan seperti:

app/Console/Kernel.php
$schedule->command('analytics:report') ->daily() ->runInBackground();
phpCopy

Dengan begitu, C tidak akan menunggu B kelar, baru jalan.

Produksi

Jika kalian menggunakan Laravel forge, maka hal tersebut akan sangat mudah untuk di lakukan pada menu scheduler.

Dan jika kalian tidak menggunakan Laravel forge, harusnya kalian bisa menggunakan Crontab untuk menjalankan sechedule itu.

Semoga artikel ini dapat bermanfaat untuk kita semua ya. Jika ada salah kata saya mohon maaf. Saya Irsyad, dan sampai jumpa lagi.

Irsyad A. Panjaitan

Let's start living like no one can help us in any event, so that when we are helped in certain times, it becomes a plus in itself.
4

Share on