Bagaimana penjadualan tugas (task scheduling) berfungsi?

Question

Accepted Answer

**Penjadual tugas** Laravel membenarkan anda mentakrif tugas berjadual (berulang) — seperti laporan harian, pembersihan, atau menghantar peringatan — secara fasih **dalam kod**, dan bukannya menguruskan banyak entri cron individu. Satu entri cron tunggal menjalankan penjadual Laravel, yang kemudiannya menjalankan tugas yang anda takrif pada masa yang dijadualkan.

## 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.
```

## Mentakrif tugas berjadual (dalam kod)

```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 ditakrif dengan **API yang fasih dan mudah dibaca** — anda boleh menjadualkan perintah Artisan, job yang dibariskan, atau closure dengan method frekuensi yang ekspresif (`daily()`, `everyFifteenMinutes()`, `dailyAt()`), kesemuanya dalam kod yang dikawal versi dan bukannya entri crontab yang berselerak.

## Entri cron tunggal yang memacunya

```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
```

Satu entri ini menjalankan `schedule:run` setiap minit; Laravel menyemak tugas yang anda takrif yang sudah tiba masanya dan menjalankannya. Anda tidak pernah menyentuh crontab lagi — semua penjadualan berada dalam kod.

## Pilihan 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 ia penting

Penjadualan tugas adalah penting untuk mana-mana aplikasi dengan **kerja latar belakang berulang** — laporan harian, pembersihan berkala, menghantar peringatan/ringkasan, menyegerakkan data, memproses kelompok — yang merupakan keperluan lazim, dan penjadual Laravel menjadikan pengurusan tugas sebegitu jauh lebih bersih berbanding cron tradisional.

Manfaat terasnya ialah mentakrif semua tugas berjadual **secara fasih dalam kod yang dikawal versi** dan bukannya sebagai entri crontab yang berselerak dan khusus-pelayan: ini memastikan logik penjadualan bersama aplikasi anda (boleh disemak, boleh dideploy, konsisten merentas persekitaran) dan menggunakan API yang ekspresif (`daily()`, `everyFifteenMinutes()`, `dailyAt()`) yang jauh lebih mudah dibaca daripada sintaks cron.

Reka bentuk yang bijak — satu **entri cron tunggal** yang menjalankan `schedule:run` setiap minit, yang kemudiannya melaksanakan tugas anda yang sudah tiba masanya — bermakna anda menyediakan cron sekali sahaja dan tidak pernah menyentuhnya lagi, menguruskan semua penjadualan dalam kod.

Memahami cara mentakrif tugas berjadual (perintah, job, closure dengan method frekuensi), persediaan entri cron tunggal, dan pilihan berguna (`withoutOverlapping`, `onOneServer` untuk keselamatan berbilang pelayan) ialah pengetahuan bernilai untuk membina aplikasi yang melaksanakan kerja automatik berulang.

Memandangkan tugas berjadual/berkala ialah keperluan dunia sebenar yang kerap, dan kerana penjadual Laravel menyediakan alternatif yang bersih, dikawal versi, dan ekspresif kepada pengurusan entri cron mentah, mengetahui cara penjadualan tugas berfungsi ialah pengetahuan peringkat senior yang penting untuk membina aplikasi yang boleh diselenggara dengan operasi berulang automatik — satu keperluan praktikal yang lazim yang ditangani penjadual dengan elegan.