Kif jaħdem l-iskejdujar tal-kompiti?

Question

Accepted Answer

L-**iskejdujar tal-kompiti** ta' Laravel jippermettilek tiddefinixxi kompiti skejdulati (li jirrepetu) — bħal rapporti ta' kuljum, nettezza, jew l-invio ta' tfakkira — fluwentement **fil-kodiċi**, minflok ma tiġġestixxi bosta dħul ta' cron individwali. Entrata waħda ta' cron toppoġġi l-iskejdujar ta' Laravel, li mbagħad toppoġġi l-kompiti tiegħek definiti f'il-ħinijiet skejdulati tagħhom.

## Il-problema li tsolvi

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

## Tiddefinissi kompiti skejdulati (fil-kodiċi)

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

L-kompiti huma definiti b'**API fluwenti u leggibli** — tista' tiskejdula kmandi Artisan, impjiegi fil-kju, jew ċlusuri b'metodi ta' frekwenza espressivi (`daily()`, `everyFifteenMinutes()`, `dailyAt()`), kollha fil-kodiċi taħt il-verżjoni kontrollata minflok dispersi fil-dħul ta' crontab.

## L-entrata ta' cron waħda li todlohha

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

Din l-entrata waħda toppoġġi `schedule:run` kull minuta; Laravel tiċċekkja liema mill-kompiti definiti tiegħek huma dovuti u toppoġġihom. Qatt ma tgeħ il-crontab - l-iskejdular kollu jgħix fil-kodiċi.

## Għażliet utli

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

## Għaliex hu importanti

L-iskejdujar tal-kompiti hu importanti għal kwalunkwe applikazzjoni b'**ħidma ta' sfond li tirrepetu** — rapporti ta' kuljum, nettezza perjodika, l-invio ta' tfakkira/diġesti, sinkronizzazzjoni ta' data, ipproċessar ta' lottijiet — li hu bżonn komuni, u l-iskejdujar ta' Laravel jagħmel il-ġestjoni ta' tali kompiti ħafna aktar nadifa mill-cron tradizzjonali.
\
-benefiċċju ewlenku hu tiddefinixxi l-kompiti skejdulati kollha **fluwentement fil-kodiċi taħt il-verżjoni kontrollata** minflok bħala dħuliet ta' crontab dispersi u speċifiċi għas-server: dan iżomm il-loġika tal-iskejdujar ma l-applikazzjoni tiegħek (reviżjonibbli, distribwibbli, konsistenti fuq l-ambjenti) u juża API espressiv (`daily()`, `everyFifteenMinutes()`, `dailyAt()`) li hu ħafna aktar leggibli mill-sintassi ta' cron.
\
-disinn intelligenti — **entrata ta' cron waħda** li toppoġġi `schedule:run` kull minuta, li mbagħad toppoġġi l-kompiti dovuti tiegħek — ifisser li iserraħ up il-cron darba u qatt m'agħti tgiħ, taġġestixxi l-iskejdujar kollu fil-kodiċi.
\
ifhem kif tiddefinixxi l-kompiti skejdulati (kmandi, impjiegi, ċlusuri b'metodi ta' frekwenza), il-konfigurazzjoni ta' entrata ta' cron waħda, u għażliet utli (`withoutOverlapping`, `onOneServer` għas-sigurtà multi-server) hu għarfien valuz għall-bini ta' applikazzjonijiet li jwettqu ħidma awtomatika li tirrepetu.
\
bħal li l-kompiti skejdulati/perjodiki huma bżonn frekwenti real-world, u bħal li l-iskejdujar ta' Laravel jipprovdi alternattiva nadifa, taħt il-verżjoni kontrollata, u espressiva għall-ġestjoni ta' dħuliet ta' cron mħallfa, it-taf kif jaħdem l-iskejdujar tal-kompiti hu għarfien importanti tal-livell sennjuri għall-bini ta' applikazzjonijiet maħfuża b'operazzjonijiet awtomatiki li jirrepetu — bżonn komuni u prattiku li l-iskejdujar jaħdem biha b'mod eleganti.