Laravel میں queued jobs کیسے کام کرتے ہیں؟

Question

Accepted Answer

Laravel کا **queue system** آپ کو وقت لینے والے کام (ای میلیں بھیجنا، فائلوں کی processing کرنا، سست APIs کو کال کرنا) کو **پس منظر میں** چلانے کے لیے معطل کرنے کی اجازت دیتا ہے، تاکہ صارف کو تیز رفتار جواب ملے۔ کام **Jobs** کے طور پر encapsulated ہوتے ہیں، queue پر push کیے جاتے ہیں، اور الگ **worker** processes سے process کیے جاتے ہیں۔

## مسئلہ جو queues حل کرتے ہیں

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

## ایک job کو define اور dispatch کرنا

```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` کو implement کرنا ایک job کو queueable بناتا ہے۔ `dispatch()` اسے queue پر push کرتا ہے اور فوری طور پر واپس آتا ہے — صارف کام کے لیے انتظار نہیں کرتا۔

## Jobs کو process کرنا (workers)

```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** process queue سے jobs نکالتا ہے اور انہیں چلاتا ہے۔ Queue backends میں Redis، database، 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
```

## یہ کیوں اہم ہے

Queued jobs responsive، scalable Laravel applications بنانے کے لیے ضروری ہیں — request cycle سے سست یا deferred کام کو offload کرنا ایک عام، اہم ضرورت ہے، اور Laravel کا queue system اسے elegant بناتا ہے۔

اس کو سمجھنا قیمتی ہے کیونکہ وقت لینے والے کام کو inline کرنا (ای میلیں بھیجنا، میڈیا process کرنا، رپورٹیں تیار کرنا، سست بیرونی services کو کال کرنا) صارفین کو انتظار میں ڈالتا ہے، request timeouts کا خطرہ پیدا کرتا ہے، اور ناکام ہونے پر کام ضائع ہو جاتا ہے — جبکہ اسے **queue** کرنے سے صارف کو فوری طور پر جواب دے سکتے ہیں جبکہ background **worker** اسے قابل اعتماد طریقے سے process کرتا ہے۔

سادہ async offloading سے ہٹ کر، Laravel کے queues اہم production capabilities فراہم کرتے ہیں: **automatic retries with backoff** (عارضی failures کے خلاف لچکدار پن)، **persistence** (jobs queue backend کے ذریعے crashes/restarts سے بچ جاتے ہیں، تو کام ضائع نہیں ہوتا)، failed-job handling، delayed dispatch، اور Horizon کے ذریعے monitoring۔

یہ جاننا اہم ہے کہ jobs کو کیسے define کریں (`ShouldQueue`)، انہیں dispatch کریں (فوری طور پر واپسی)، workers کے ساتھ process کریں (`queue:work`، production میں supervised)، اور اعتماد کی خصوصیات کو configure کریں — یہ ان applications کو بنانے کے لیے ضروری علم ہے جو بھاری یا deferred کام کو gracefully سنبھالتے ہیں۔

چونکہ responsive applications معمول کے طور پر کام کو background میں offload کرنے کی ضرورت رکھتے ہیں — اور چونکہ Laravel کا queue system built-in reliability کے ساتھ اس کا elegant، idiomatic طریقہ ہے — jobs اور queues میں مہارت حاصل کرنا production-grade Laravel applications بنانے کے لیے اکثر متعلقہ، اہم علم ہے جو real-world workloads کے تحت تیز اور قابل اعتماد رہتے ہیں۔