Laravel मा queued jobs कसरी काम गर्छन्?

Question

Accepted Answer

Laravel को **queue system** ले समय लाग्ने कार्यहरू (इमेल पठाउने, फाइल प्रशोधन गर्ने, ढिलो APIs कल गर्ने) **पृष्ठभूमिमा** चलाउन स्थगित गर्न दেय, ताकि प्रयोगकर्तालाई द्रुत प्रतिक्रिया मिल्छ। कार्यहरू **Jobs** को रूपमा बन्द गरिन्छन्, queue मा धकेलिन्छन्, र अलग अलग **worker** प्रक्रियाहरूले प्रशोधन गर्छन्।

## समस्या जो 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 परिभाषित र 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` लागू गर्नु भनेको job लाई queueable बनाउनु हो। `dispatch()` यसलाई queue मा धकेल्छ र तुरुन्त फर्काउँछ — प्रयोगकर्ता काम को लागि प्रतीक्षा गर्दैनन्।

## Jobs प्रशोधन गर्ने (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** प्रक्रियाले 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 प्रतिक्रियाशील, scalable Laravel अनुप्रयोग बनाउन आवश्यक छन् — request cycle बाट ढिलो वा स्थगित काम गर्न अनुमति दिनु एक साधारण, महत्वपूर्ण आवश्यकता हो, र Laravel को queue system यसलाई सुरुचिपूर्ण बनाउँछ।

यो बुझ्न मूल्यवान छ किनभने समय लाग्ने काम inline मा गर्ने (इमेल पठाउने, मिडिया प्रशोधन गर्ने, रिपोर्ट उत्पन्न गर्ने, ढिलो बाह्य सेवाहरू कल गर्ने) प्रयोगकर्तालाई प्रतीक्षा गराउँछ, request timeouts को जोखिम राख्छ, र असफल हले काम गुमाउँछ — जबकि **queuing** गर्नु भनेको प्रयोगकर्तालाई तुरुन्त प्रतिक्रिया दिन दिन्छ जबकि पृष्ठभूमि **worker** यसलाई विश्वसनीय रूपमा प्रशोधन गर्छ।

सरल async offloading भन्दा बाहिर, Laravel को queues महत्वपूर्ण production क्षमताहरू प्रदान गर्छन्: **automatic retries with backoff** (क्षणिक असफलताहरू विरुद्ध स्थिरता), **persistence** (jobs queue backend को माध्यमबाट crashes/restarts बाँच्छन्, त्यसैले काम गुमिदैन), failed-job handling, delayed dispatch, र Horizon को माध्यमबाट monitoring।

जब jobs परिभाषित गर्ने (`ShouldQueue`), तिनलाई dispatch गर्ने (तुरुन्त फर्काउने), workers (`queue:work`, production मा supervised) सँग प्रशोधन गर्ने, र विश्वसनीयता विशेषताहरू कन्फिगर गर्ने बुझ्न महत्वपूर्ण ज्ञान हो भारी वा स्थगित काम लाई सुरुचिपूर्ण तरिकाले संभालने अनुप्रयोग बनाउनको लागि।

प्रतिक्रियाशील अनुप्रयोगहरूलाई नियमित रूपमा पृष्ठभूमिमा काम गर्न आवश्यक हुँदा — र Laravel को queue system सो गर्ने सुरुचिपूर्ण, idiomatic तरिका अन्तर्निहित विश्वसनीयता सँग हुँदा — jobs र queues मा निपुण हुनु production-grade Laravel अनुप्रयोग बनाउनको लागि बारम्बार-प्रासंगिक, महत्वपूर्ण ज्ञान हो जो वास्तविक-विश्व workloads अन्तर्गत द्रुत र विश्वसनीय रहन्छन्।