كيف يعمل جدولة المهام؟

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

يقوم هذا الإدخال الواحد بتشغيل `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 متفرقة وخاصة بالخادم: هذا يحافظ على منطق الجدولة مع تطبيقك (قابل للمراجعة وقابل للنشر ومتسق عبر البيئات) ويستخدم API معبر (`daily()`، `everyFifteenMinutes()`، `dailyAt()`) أسهل بكثير من بناء جملة cron.

التصميم الذكي — **إدخال cron واحد** يشغل `schedule:run` كل دقيقة، والذي بعد ذلك ينفذ مهامك المستحقة — يعني أنك تعد cron مرة واحدة ولا تلمسه مرة أخرى، وتدير جميع الجدولة في الكود.

فهم كيفية تحديد المهام المجدولة (الأوامر والوظائف والإغلاقات مع طرق التكرار)، وإعداد إدخال cron الواحد، والخيارات المفيدة (`withoutOverlapping`، `onOneServer` لأمان الخوادم المتعددة) هو معرفة قيمة لبناء التطبيقات التي تؤدي عملاً متكرراً مؤتمتاً.

نظراً لأن المهام المجدولة/الدورية هي متطلب متكرر في العالم الحقيقي، وبما أن جدول Laravel يوفر بديلاً نظيفاً وتحت التحكم بالإصدارات وقابلاً للتعبير عن إدارة إدخالات cron الخام، فإن معرفة كيفية عمل جدولة المهام هي معرفة مهمة على مستوى أعلى لبناء التطبيقات القابلة للصيانة مع العمليات المتكررة المؤتمتة — وهي حاجة شائعة وعملية يتعامل معها الجدول بأناقة.