كيف تعمل الوظائف المتأخرة (Queued Jobs) في Laravel؟

Question

Accepted Answer

نظام **الطوابير** في Laravel يسمح لك بتأجيل المهام التي تستغرق وقتاً طويلاً (إرسال رسائل بريد إلكترونية، معالجة الملفات، استدعاء APIs بطيئة) للتشغيل **في الخلفية**، بحيث يحصل المستخدم على استجابة سريعة. يتم تغليف المهام كـ **Jobs**، وإضافتها إلى الطابور، ومعالجتها بواسطة عمليات **worker** منفصلة.

## المشكلة التي تحلها الطوابير

```text
Slow work done inline makes the user wait and risks request timeouts:
  ✗ sending emails, processing images/video, generating reports, calling slow APIs
  ✓ QUEUE it → respond to the user immediately → a worker handles it in the background
```

## تعريف وإرسال الوظيفة

```php
<?php
// php artisan make:job ProcessPodcast
class ProcessPodcast implements ShouldQueue {
    public function __construct(public Podcast $podcast) {}

public function handle(): void {
        // the slow work — runs in a WORKER, not the web request
        $this->podcast->process();
    }
}
```

```php
// dispatch the job — pushes it onto the queue, returns IMMEDIATELY
ProcessPodcast::dispatch($podcast);
ProcessPodcast::dispatch($podcast)->delay(now()->addMinutes(10));   // delayed
```

تطبيق `ShouldQueue` يجعل الوظيفة قابلة للطابور. `dispatch()` يضيفها إلى الطابور وينتهي على الفور — المستخدم لا ينتظر إنجاز العمل.

## معالجة الوظائف (العمال)

```bash
php artisan queue:work          # run a worker to process queued jobs
# in production: run workers as a supervised process (Supervisor) or use Horizon
```

عملية **worker** منفصلة تسحب الوظائف من الطابور وتشغلها. تشمل خيارات الطابور Redis وقاعدة البيانات وSQS وغيرها.

## ميزات الموثوقية

```php
class ProcessPodcast implements ShouldQueue {
    public $tries = 3;             // retry up to 3 times on failure
    public $backoff = 60;          // wait 60s between retries
    public function failed(Throwable $e): void { /* handle final failure */ }
}
```

```text
✓ Retries with backoff (resilience), failed-job handling
✓ Persistence (jobs survive restarts via the queue backend)
✓ Laravel Horizon → a dashboard for monitoring/managing Redis queues
```

## لماذا يهم ذلك

الوظائف المتأخرة ضرورية لبناء تطبيقات Laravel سريعة الاستجابة وقابلة للتوسع — نقل العمل البطيء أو المؤجل من دورة الطلب هو احتياج شائع ومهم، ونظام الطوابير في Laravel يجعله أنيقاً.
ffهم هذا مفيد لأن إجراء العمل الذي يستغرق وقتاً طويلاً بشكل متزامن (إرسال رسائل بريد، معالجة الوسائط، توليد التقارير، استدعاء الخدمات الخارجية البطيئة) يجعل المستخدمين ينتظرون، ويعرض الطلب لخطر المهلة الزمنية، ويفقد العمل إذا فشل — في حين أن **الطابورة** تسمح لك بالرد على المستخدم على الفور بينما **عامل** خلفي معين يعالجها بموثوقية.

بعيداً عن مجرد نقل غير متزامن بسيط، توفر طوابير Laravel قدرات إنتاجية مهمة: **إعادة المحاولة التلقائية مع التراجع** (المرونة ضد الأخطاء العابرة)، **الاستمرارية** (تستمر الوظائف في العيش عند الأعطال/إعادة التشغيل عبر خلفية الطابور، لذلك لا يضيع العمل)، معالجة الوظائف الفاشلة، الإرسال المؤجل، والمراقبة عبر Horizon.

فهم كيفية تعريف الوظائف (`ShouldQueue`)، وإرسالها (العودة على الفور)، ومعالجتها مع العمال (`queue:work`، الخاضعة للإشراف في الإنتاج)، وتكوين ميزات الموثوقية هو معرفة مهمة لبناء التطبيقات التي تتعامل مع العمل الثقيل أو المؤجل بشكل أنيق.

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