Bagaimana cara kerja penjadwalan tugas?

Question

Accepted Answer

**Task scheduler** Laravel memungkinkan Anda mendefinisikan tugas yang dijadwalkan (berulang) — seperti laporan harian, pembersihan, atau pengiriman pengingat — secara fluent **dalam kode**, alih-alih mengelola banyak entri cron individual. Satu entri cron menjalankan scheduler Laravel, yang kemudian menjalankan tugas yang Anda tentukan pada waktu yang dijadwalkan.

## Masalah yang diselesaikannya

```text
Traditionally, each recurring task needs its own crontab entry on the server
→ scattered, hard to version-control, server-specific, error-prone.
Laravel: define ALL scheduled tasks in code (version-controlled), with ONE cron entry.
```

## Mendefinisikan tugas yang dijadwalkan (dalam kode)

```php
<?php
// in the schedule definition (app/Console/Kernel.php or routes/console.php)
$schedule->command('reports:generate')->daily();
$schedule->command('emails:reminders')->hourly();
$schedule->job(new CleanupJob)->everyFifteenMinutes();
$schedule->call(fn() => DB::table('sessions')->where(...)->delete())->dailyAt('02:00');

// expressive frequency methods:
->everyMinute() ->hourly() ->daily() ->weekly() ->monthly()
->dailyAt('13:00') ->weekdays() ->cron('0 0 * * *')   // or a raw cron expression
```

Tugas didefinisikan dengan **API fluent yang mudah dibaca** — Anda dapat menjadwalkan perintah Artisan, queued jobs, atau closures dengan metode frekuensi yang ekspresif (`daily()`, `everyFifteenMinutes()`, `dailyAt()`), semuanya dalam kode yang terkontrol versi daripada tersebar di entri crontab.

## Satu entri cron yang menggerakkannya

```bash
# add ONE cron entry on the server — runs the scheduler every minute
* * * * * cd /path-to-app && php artisan schedule:run >> /dev/null 2>&1
```

Entri ini menjalankan `schedule:run` setiap menit; Laravel memeriksa tugas mana dari yang Anda tentukan yang telah tiba waktunya dan menjalankannya. Anda tidak perlu menyentuh crontab lagi — semua penjadwalan hidup dalam kode.

## Opsi yang berguna

```php
$schedule->command('backup')->daily()
    ->withoutOverlapping()        // don't start if the previous run is still going
    ->onOneServer()                // in multi-server setups, run on only ONE server
    ->emailOutputOnFailure('ops@x.com');
```

## Mengapa ini penting

Penjadwalan tugas penting untuk aplikasi apa pun dengan **pekerjaan latar belakang berulang** — laporan harian, pembersihan berkala, pengiriman pengingat/digests, sinkronisasi data, pemrosesan batch — yang merupakan kebutuhan umum, dan scheduler Laravel membuat pengelolaan tugas-tugas tersebut jauh lebih rapi daripada cron tradisional.

Manfaat inti adalah mendefinisikan semua tugas yang dijadwalkan **secara fluent dalam kode yang terkontrol versi** daripada sebagai entri crontab yang tersebar dan spesifik server: ini menjaga logika penjadwalan dengan aplikasi Anda (dapat direview, dapat di-deploy, konsisten di semua lingkungan) dan menggunakan API yang ekspresif (`daily()`, `everyFifteenMinutes()`, `dailyAt()`) yang jauh lebih mudah dibaca daripada sintaks cron.

Desain yang cerdas — **satu entri cron** menjalankan `schedule:run` setiap menit, yang kemudian mengeksekusi tugas-tugas Anda yang telah tiba — berarti Anda menyiapkan cron sekali dan tidak perlu menyentuhnya lagi, mengelola semua penjadwalan dalam kode.

Memahami cara mendefinisikan tugas yang dijadwalkan (perintah, jobs, closures dengan metode frekuensi), pengaturan entri-cron-tunggal, dan opsi yang berguna (`withoutOverlapping`, `onOneServer` untuk keamanan multi-server) adalah pengetahuan berharga untuk membangun aplikasi yang melakukan pekerjaan otomatis berulang.

Karena tugas yang dijadwalkan/berkala adalah persyaratan dunia nyata yang sering terjadi, dan karena scheduler Laravel menyediakan alternatif yang bersih, terkontrol versi, dan ekspresif untuk mengelola entri cron mentah, mengetahui cara kerja penjadwalan tugas adalah pengetahuan level senior yang penting untuk membangun aplikasi yang dapat dipertahankan dengan operasi berulang otomatis — kebutuhan yang umum dan praktis yang ditangani scheduler dengan elegan.