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 ਪ੍ਰਤਿਕ੍ਰਿਆਸ਼ੀਲ, ਪ੍ਰਾਪਤ Laravel ਐਪਲੀਕੇਸਨਾਂ ਬਣਾਉਣ ਲਈ ਜ਼ਰੂਰੀ ਹਨ — ਮੰਦ ਜਾਂ ਅਥਾਲਿਤ ਕੰਮ ਨੂੰ request cycle ਤੋਂ ਹਟਾਉਣਾ ਇੱਕ ਆਮ, ਮਹੱਤਵਪੂਰਨ ਲੋੜ ਹੈ, ਅਤੇ Laravel ਦਾ queue system ਇਸਨੂੰ ਸੁੱਦਾ ਬਣਾਉਂਦਾ ਹੈ।

ਇਸਨੂੰ ਸਮਝਣਾ ਮਹੱਤਵਪੂਰਨ ਹੈ ਕਿਉਂਕਿ ਸਮੇਂ ਖਪਤ ਵਾਲਾ ਕੰਮ inline ਵਿੱਚ ਕਰਨਾ (ਈ-ਮੇਲ ਭੇਜਣਾ, ਮੀਡੀਆ ਦੀ ਪ੍ਰਕਿਰਿਆ, ਰਿਪੋਰਟਾਂ ਤਿਆਰ ਕਰਨਾ, ਸਸਤੀਆਂ ਬਾਹਰੀ ਸੇਵਾਵਾਂ ਨੂੰ ਕਾਲ ਕਰਨਾ) ਉਪਭੋਗਤਾਵਾਂ ਨੂੰ ਉਡੀਕ ਕਰਾਉਂਦਾ ਹੈ, request timeouts ਦਾ ਖਤਰਾ ਰੱਖਦਾ ਹੈ, ਅਤੇ ਕੰਮ ਗੁਆ ਦਿੰਦਾ ਹੈ ਜੇਕਰ ਇਹ ਅਸਫਲ ਹੋ — ਜਦਕਿ **queuing** ਇਸਨੂੰ ਤੁਰੰਤ ਉਪਭੋਗਤਾ ਨੂੰ ਜਵਾਬ ਦੇਣ ਦਿੰਦਾ ਹੈ ਜਦਕਿ ਇੱਕ background **worker** ਇਸਨੂੰ ਭਰੋਸੇਯੋਗੀ ਨਾਲ ਪ੍ਰਕਿਰਿਆ ਕਰਦਾ ਹੈ।

ਸਧਾਰਨ async offloading ਤੋਂ ਪਰੇ, Laravel ਦੇ queues ਮਹੱਤਵਪੂਰਨ production ਸਮਰੱਥਾਵਾਂ ਪ্ਰਦਾਨ ਕਰਦੇ ਹਨ: **automatic retries with backoff** (ਅਸਥਾਈ ਅਸਫਲਤਾਵਾਂ ਦੇ ਵਿਰੁੱਧ ਲਚਕਦਾਰੀ), **persistence** (jobs queue backend ਦੁਆਰਾ crashes/restarts ਤੋਂ ਬਚਦੇ ਹਨ, ਤਾਂ ਕੰਮ ਗੁਆ ਨਹੀਂ ਜਾਂਦਾ), ਅਸਫਲ-job ਹੈਂਡਲਿੰਗ, ਦੇਰੀ ਨਾਲ dispatch, ਅਤੇ Horizon ਦੁਆਰਾ ਨਿਗਰਾਨੀ।

Jobs ਨੂੰ ਪਰਿਭਾਸ਼ਿਤ ਕਰਨਾ (`ShouldQueue`), ਉਹਨਾਂ ਨੂੰ dispatch ਕਰਨਾ (ਤੁਰੰਤ ਮੁੜ ਆਉਣਾ), ਉਹਨਾਂ ਨੂੰ workers ਦੇ ਨਾਲ ਪ੍ਰਕਿਰਿਆ ਕਰਨਾ (`queue:work`, production ਵਿੱਚ supervised), ਅਤੇ ਭਰੋਸੇਯੋਗਤਾ ਦੀਆਂ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਨੂੰ ਸੰਰਚਿਤ ਕਰਨਾ ਸਮਝਣਾ ਮਹੱਤਵਪੂਰਨ ਗਿਆਨ ਹੈ ਤਾਂ ਕਿ ਐਪਲੀਕੇਸਨਾਂ ਭਾਰੀ ਜਾਂ ਅਥਾਲਿਤ ਕੰਮ ਨੂੰ ਸੁਨਮੁਣਾ ਨਾਲ ਸੰਭਾਲ ਸਕਣ।

ਕਿਉਂਕਿ ਪ੍ਰਤਿਕ੍ਰਿਆਸ਼ੀਲ ਐਪਲੀਕੇਸਨਾਂ ਨੂੰ ਨਿਯਮਿਤ ਤੌਰ ਉੱਤੇ background ਨੂੰ ਕੰਮ ਹਟਾਉਣਾ ਪੈਂਦਾ ਹੈ — ਅਤੇ ਕਿਉਂਕਿ Laravel ਦਾ queue system ਅੰਤਰਨਿਰਮਿਤ ਭਰੋਸੇਯੋਗਤਾ ਦੇ ਨਾਲ ਸੁੱਦਾ, idiomatic ਤਰੀਕਾ ਹੈ — jobs ਅਤੇ queues ਵਿੱਚ ਮਾਹਿਰ ਹੋਣਾ ਅਕਸਰ ਮਾਸਿਕ-ਸੁਸੰਗਤ, ਮਹੱਤਵਪੂਰਨ ਗਿਆਨ ਹੈ ਤਾਂ ਕਿ production-grade Laravel ਐਪਲੀਕੇਸਨਾਂ ਬਣਾ ਸਕੀਏ ਜੋ ਵਾਸਤਵਿਕ-ਸੰਸਾਰ ਕਾਰਜ ਲੋਡ ਦੇ ਅਧੀਨ ਤੇਜ਼ ਅਤੇ ਭਰੋਸੇਯੋਗ ਰਹਿਣ।