タスクスケジューリングはどのように機能しますか？

Question

Accepted Answer

Laravel の **タスクスケジューラ** を使えば、スケジュール済み（繰り返し実行される）タスク（日次レポート、クリーンアップ、リマインダー送信など）を、多くの個別の cron エントリを管理する代わりに、**コード内で** 流暢に定義できます。単一の cron エントリが Laravel のスケジューラを実行し、定義されたタスクを指定時刻に実行します。

## 解決する問題

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

## スケジュール済みタスクの定義（コード内）

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

タスクは **流暢で読みやすい API** で定義されます。Artisan コマンド、キューに入ったジョブ、またはクロージャをスケジュール可能であり、表現力豊かな周期メソッド（`daily()`、`everyFifteenMinutes()`、`dailyAt()`）を使用して、バージョン管理されたコード内で定義します。散らばった crontab エントリではなく管理できます。

## それを駆動する単一の cron エントリ

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

この 1 つのエントリは毎分 `schedule:run` を実行します。Laravel は定義されたタスクのうち実行予定のものを確認し、それらを実行します。crontab に二度と触れることはありません。すべてのスケジューリングはコード内に存在します。

## 便利なオプション

```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');
```

## なぜ重要なのか

タスクスケジューリングは **繰り返される背景タスク**（日次レポート、定期的なクリーンアップ、リマインダー/ダイジェスト送信、データ同期、バッチ処理）を持つすべてのアプリケーションにとって重要です。これは一般的なニーズであり、Laravel のスケジューラはそのようなタスクの管理を従来の cron よりもはるかにクリーンにします。

コアの利点は、スケジュール済みタスクをすべて **流暢にバージョン管理されたコード内で** 定義でき、散らばったサーバー固有の crontab エントリではなくすることです。これにより、スケジューリングロジックがアプリケーション（レビュー可能、デプロイ可能、環境間で一貫性あり）とともに保持され、cron 構文よりもはるかに読みやすい表現力豊かな API（`daily()`、`everyFifteenMinutes()`、`dailyAt()`）を使用します。

巧妙な設計（毎分 `schedule:run` を実行する **単一の cron エントリ** で、その後定義済みタスクを実行）により、cron を 1 度設定したら二度と触れることなく、すべてのスケジューリングをコード内で管理できます。

スケジュール済みタスク（コマンド、ジョブ、周期メソッド付きクロージャ）の定義方法、単一の cron エントリのセットアップ、および有用なオプション（マルチサーバー安全性のための `withoutOverlapping`、`onOneServer`）の理解は、繰り返される自動タスクを実行するアプリケーション構築のための貴重な知識です。

スケジュール済み/定期的なタスクは実世界で頻繁に必要とされ、Laravel のスケジューラは生の cron エントリを管理するのに対して、クリーンでバージョン管理可能で表現力豊かな代替手段を提供するため、タスクスケジューリングがどのように機能するかを理解することは、自動化された繰り返し操作を伴う保守性の高いアプリケーション構築のための重要なシニアレベルの知識です。これは一般的で実用的なニーズであり、スケジューラはそれを優雅に処理します。