Görev zamanlayıcısı nasıl çalışır?

Question

Accepted Answer

Laravel'in **görev zamanlayıcısı**, zamanlanmış (tekrarlayan) görevleri — günlük raporlar, temizlik veya hatırlatıcı gönderme gibi — birçok bireysel cron girişini yönetmek yerine **kod içinde** akıcı bir şekilde tanımlamanıza olanak tanır. Tek bir cron girişi Laravel'in zamanlayıcısını çalıştırır ve bu da tanımlanan görevleri belirlenen zamanlarda çalıştırır.

## Çözdüğü sorun

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

## Zamanlanmış görevleri tanımlama (kod içinde)

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

Görevler **akıcı, okunabilir bir API** ile tanımlanır — Artisan komutları, kuyruğa alınmış işler veya closure'ları ifadeli sıklık yöntemleriyle (`daily()`, `everyFifteenMinutes()`, `dailyAt()`) zamanlayabilirsiniz, hepsi sürüm kontrolü altındaki kod içinde, dağınık crontab girişleri yerine.

## Bunu çalıştıran tek cron girişi

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

Bu tek giriş `schedule:run` komutunu her dakika çalıştırır; Laravel tanımlanan görevlerinizden hangilerinin zamanı geldiğini kontrol eder ve onları çalıştırır. Crontab'a bir daha asla dokunmazsınız — tüm zamanlama kod içinde yaşar.

## Yararlı seçenekler

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

## Neden önemli

Görev zamanlayıcısı **tekrarlayan arka plan çalışması** gerektiren herhangi bir uygulama için önemlidir — günlük raporlar, periyodik temizlik, hatırlatıcı/özet gönderme, veri senkronizasyonu, toplu işlem — bu yaygın bir ihtiyaçtır ve Laravel'in zamanlayıcısı bu tür görevleri yönetmeyi geleneksel cron'dan çok daha temiz hale getirir.

Temel fayda, tüm zamanlanmış görevleri **dağınık, sunucuya özel crontab girişleri yerine akıcı şekilde sürüm kontrolü altındaki kod içinde** tanımlamaktır: bu zamanlama mantığını uygulamanızın yanında tutar (gözden geçirilebilir, dağıtılabilir, ortamlar arasında tutarlı) ve cron sözdizimine göre çok daha okunabilir olan ifadeli bir API (`daily()`, `everyFifteenMinutes()`, `dailyAt()`) kullanır.

Zekilik tasarımı — **tek bir cron girişi** her dakika `schedule:run` komutunu çalıştırır ve ardından yazılımı çalıştırır — cron'u bir kez ayarlar ve bir daha asla dokunmazsınız, tüm zamanlama kod içinde yönetilir.

Zamanlanmış görevleri tanımlama (sıklık yöntemleriyle komutlar, işler, closure'lar), tek cron girişi kurulumu ve yararlı seçenekleri (`withoutOverlapping`, çok sunuculu güvenlik için `onOneServer`) anlamak, tekrarlayan otomasyonlu çalışma yapan uygulamalar oluşturmak için değerli bilgidir.

Zamanlanmış/periyodik görevler sık karşılaşılan gerçek dünya gereksinimidir ve Laravel'in zamanlayıcısı ham cron girişlerini yönetmeye karşı temiz, sürüm kontrolü altında, ifadeli bir alternatif sağladığından, görev zamanlayıcısının nasıl çalıştığını bilmek tekrarlayan otomasyonlu işlemler ile — zamanlayıcının zarif bir şekilde ele aldığı yaygın, pratik bir ihtiyaç — bakımlanabilir uygulamalar oluşturmak için önemli üst seviye bilgidir.