Hi, I’m Silrag Mrong
a Web Backend Developer UI/UX Designer Coder

Laravel Queue নিয়ে একটি পূর্ণাঙ্গ গাইড

কোনো ওয়েব অ্যাপ্লিকেশনে সময়সাপেক্ষ কাজগুলো দ্রুত ও কার্যকরীভাবে সম্পন্ন করার জন্য Queue একটি অপরিহার্য অংশ। Laravel, যা একটি শক্তিশালী PHP ফ্রেমওয়ার্ক, এতে বিল্ট-ইন Queue সিস্টেম রয়েছে যা এধরনের কাজ সহজেই পরিচালনা করতে সাহায্য করে। এই ব্লগে আমরা Laravel Queue সম্পর্কে বিস্তারিত আলোচনা করব, এর সেটআপ, ব্যবহার এবং বাস্তব প্রয়োগ নিয়ে।

Laravel Queue কী?

Laravel Queue একটি সিস্টেম যা দীর্ঘ সময়সাপেক্ষ কাজগুলোকে পরে সম্পন্ন করার জন্য সংরক্ষণ করে। এটি আপনার অ্যাপ্লিকেশনের প্রধান কার্যক্রমগুলোকে দ্রুত সম্পন্ন করার সুযোগ দেয় এবং ব্যাকগ্রাউন্ডে নির্ধারিত কাজগুলো চালিয়ে যেতে পারে।

Queue এর ব্যবহার:

ইমেইল পাঠানো

ফাইল প্রসেসিং (যেমন: ইমেজ বা ভিডিও)

রিপোর্ট তৈরি

API ডেটা সিঙ্ক্রোনাইজেশন

নোটিফিকেশন বা SMS পাঠানো

Laravel Queue কিভাবে কাজ করে

Laravel Queue আপনাকে কাজগুলো জব হিসেবে সংজ্ঞায়িত করতে এবং সেগুলো Queue তে পাঠানোর সুবিধা দেয়। Queue সিস্টেম বিভিন্ন ড্রাইভার সমর্থন করে, যেমন:

ডাটাবেজ: Queue সংরক্ষণে ডাটাবেজ ব্যবহার করা হয়।

রেডিস (Redis): দ্রুত ইন-মেমরি ডাটা স্টোর।

বিনস্টকড (Beanstalkd): একটি সরল ও দ্রুত ওয়ার্ক কিউ।

অ্যামাজন SQS: একটি ব্যবস্থাপিত মেসেজ কিউ সার্ভিস।

সিঙ্ক (Sync): কাজগুলো তাৎক্ষণিকভাবে সম্পন্ন করে (স্থানীয় পরীক্ষার জন্য উপযুক্ত)।

Laravel Queue সেটআপ

ধাপ ১: Laravel ইনস্টল করুন

Laravel এর একটি নতুন প্রোজেক্ট তৈরি করুন:

bash

CopyEdit

composer create-project laravel/laravel laravel-queue-example

ধাপ ২: Queue ড্রাইভার কনফিগার করুন

.env ফাইল থেকে QUEUE_CONNECTION ভ্যারিয়েবলটি ড্রাইভারের জন্য সেট করুন। উদাহরণস্বরূপ, ডাটাবেজ ড্রাইভারের জন্য:

env

CopyEdit

QUEUE_CONNECTION=database

ধাপ ৩: Queue টেবিল তৈরি করুন (ডাটাবেজ ড্রাইভার)

Queue টেবিল তৈরি করতে Artisan কমান্ড ব্যবহার করুন:

bash

CopyEdit

php artisan queue:table php artisan migrate

ধাপ ৪: একটি জব ক্লাস তৈরি করুন

একটি নতুন জব তৈরি করতে Artisan কমান্ড ব্যবহার করুন:

bash

CopyEdit

php artisan make:job ProcessEmail

উদাহরণ: Queue দিয়ে ইমেইল পাঠানো

ধাপ ১: জব তৈরি করুন

ProcessEmail জব ক্লাসে কোড লিখুন:

php

CopyEdit

namespace App\Jobs; use Mail; use App\Mail\NotificationEmail; use Illuminate\Bus\Queueable; use Illuminate\Queue\SerializesModels; use Illuminate\Queue\InteractsWithQueue; use Illuminate\Contracts\Queue\ShouldQueue; use Illuminate\Foundation\Bus\Dispatchable; class ProcessEmail implements ShouldQueue {    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;    public $email;    public function __construct($email)    {        $this->email = $email;    }    public function handle()    {        Mail::to($this->email)->send(new NotificationEmail());    } }

ধাপ ২: জব ডিসপ্যাচ করুন

কন্ট্রোলার থেকে জব ডিসপ্যাচ করুন:

php

CopyEdit

use App\Jobs\ProcessEmail; public function sendNotification(Request $request) {    $email = $request->input('email');    ProcessEmail::dispatch($email);    return response()->json(['message' => 'ইমেইল Queue এ পাঠানো হয়েছে!']); }

Queue প্রসেসিং

Queue প্রসেস করতে নিচের কমান্ড চালান:

bash

CopyEdit

php artisan queue:work

Laravel Queue এর উন্নত ফিচার

১. ডিলে করা জব

Queue এর জব নির্ধারিত সময় পরে প্রসেস করতে পারেন:

php

CopyEdit

ProcessEmail::dispatch($email)->delay(now()->addMinutes(10));

২. জব প্রায়োরিটি নির্ধারণ

Queue তে বিভিন্ন প্রায়োরিটি সেট করতে পারেন:

bash

CopyEdit

php artisan queue:work --queue=high,default

৩. ফেইলড জব

ফেইলড জবগুলো failed_jobs টেবিলে সংরক্ষিত হয়। এটি তৈরি করতে:

bash

CopyEdit

php artisan queue:failed-table php artisan migrate

ফেইলড জব পুনরায় চেষ্টা করতে:

bash

CopyEdit

php artisan queue:retry all

বাস্তব প্রয়োগ: ইমেজ প্রসেসিং

আপনার অ্যাপ্লিকেশনে ইমেজ রিসাইজ বা ওয়াটারমার্ক করার জন্য Queue ব্যবহার করতে পারেন। উদাহরণ:

php

CopyEdit

namespace App\Jobs; use Intervention\Image\ImageManagerStatic as Image; use Illuminate\Bus\Queueable; use Illuminate\Queue\SerializesModels; use Illuminate\Queue\InteractsWithQueue; use Illuminate\Contracts\Queue\ShouldQueue; use Illuminate\Foundation\Bus\Dispatchable; class ProcessImage implements ShouldQueue {    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;    public $imagePath;    public function __construct($imagePath)    {        $this->imagePath = $imagePath;    }    public function handle()    {        $image = Image::make($this->imagePath);        $image->resize(800, 600);        $image->insert('public/watermark.png');        $image->save($this->imagePath);    } }

উপসংহার

Laravel Queue আপনার অ্যাপ্লিকেশনে ব্যাকগ্রাউন্ড টাস্ক পরিচালনার জন্য একটি শক্তিশালী এবং কার্যকরী সমাধান। এটি ব্যবহার করে আপনি ইমেইল পাঠানো, ইমেজ প্রসেসিং বা API সিঙ্ক্রোনাইজেশনের মতো কাজগুলো সহজেই সম্পন্ন করতে পারেন। Laravel Queue ব্যবহার করে আপনার অ্যাপ্লিকেশনের পারফরম্যান্স এবং ব্যবহারকারীর অভিজ্ঞতা উন্নত করুন।

লারাভেল লাইফসাইকেল....

লারাভেল একটা রিকুয়েষ্টকে কিভাবে হ্যান্ডেল করে? আমরা সাধারানত যা দেখি যে web.php থেকে কোনো একটা রাউট কন্ট্রলারে যাচ্ছে এবং এর পর একটা রেস্পন্স পাওয়া যাচ্ছে। কিন্তু রিকুয়েষ্ট এর পুরো যাত্রাটা হয়তো অনেকের কাছেই ক্লিয়ার না। চলুন তাহলে লারাভেল লাইফসাইকেলে একবার ঘুরে আসা যাক।

রিকুয়েষ্ট এর ক্ষেত্রে যাত্রাটা শুরু হয় ওয়েব সার্ভার (এপাচি/এঞ্জিনএক্স) থেকে। আর সেখান থেকে রিকুএষ্টটি চলে আসে সরাসরি public/index.php ফাইলে। অর্থাৎ লারাভেল লাইফ সাইকেলের যাত্রা শুরু এখান থেকেই। .htaccess ফাইল এর সাহায্যে যত ধরণের রিকুয়েষ্ট আসে, সবগুলো রিকুয়েস্ট index.php তে পাঠানো হয়।

index.php এর প্রথম গুরুত্বপূর্র্ণ কাজ হলো composer থেকে জেনারেট হওয়া ভেন্ডরের ভেতরের সকল ফাইলকে রিকোয়ারর্ড করা। যার মাধ্যমে আমরা ভেন্ডরের ভেতরে থাকা ক্লাসগুলোকে আমাদের প্রজেক্টে ব্যববহার করতে পারি।

এর পরের ধাপে index.php লারাভেল এপ্লিকেশনের একটি ইন্সট্যান্স রিসিভ করে।  যে  ইন্সট্যান্সটি রিটার্রন হয়েছে bootstrap/app.php ফাইল থেকে। আমরা যদি এই ফাইলটিতে যাই তাহলে দেখবো প্রথমেই Application ক্লাসটির একটি ইনস্ট্যান্স তৈরি করা হয়েছে এবং তার কন্সট্রাক্টরে application এর বেজ পাথটি পাস্ করে দেয়া হয়েছে। আর তার পরের ধাপে ৩ তা ক্লাসকে পুরো  Application এর সাথে singleton এর মাধ্যমে বাইন্ড করে দেওয়া হয়েছে। আর তা হলো :

১। Illuminate\Contracts\Http\Kernel যাকে বাইন্ড করা হয়েছে App\Http\Kernel::class এই ক্লাসটির সাথে। অর্থাৎ Illuminate\Contracts\Http\Kernel এই ইন্টারফেসটির জন্য App\Http\Kernel::class এর ইন্সট্যান্সটি তৈরী হবে। আর এটির কাজ হলো Http থেকে আসা সকল রিকুয়েস্টগুলোকে হ্যান্ডেল করা.

২। Illuminate\Contracts\Console\Kernel যাকে বাইন্ড করা হয়েছে App\Console\Kernel::class এই ক্লাসটির সাথে। আর এটির কাজ হলো CLI - command-line interface থেকে আসা সকল রিকুয়েস্টগুলোকে হ্যান্ডেল করা.

৩। Illuminate\Contracts\Debug\ExceptionHandler::class যাকে বাইন্ড করা হয়েছে App\Exceptions\Handler::class এই ক্লাসটির সাথে। আর এই ক্লাসটিই  প্রজেক্ট এর সকল  Exception গুলোকে Handle করে।

আর এই বাইন্ডিং গুলো শেষ হলেই এপ্লিকেশনের ইন্সট্যান্সটি রিটার্র্ন হয় index.php এর কাছে।

যাত্রা এখনো শেষ হয়নি, এখনো অনেকটা পথ বাকি আছে , চলুন আগে বাড়াই।

এর পর Http রিকুয়েষ্টকে Handle করার জন্য App\Http\Kernel::class এর একটি ইন্সট্যান্স নেয়া হয় যেটাকে পুর্বেই বাইন্ড করা হয়েছিলো। আর এখানে Kernel এর handle মেথডে রিকোয়েস্ট কে ক্যাপচার করে পাঠানো হয়। যার ডেফিনেশন রয়েছে  Illuminate\Foundation\Http\Kernel এই ফাইলে। handle মেথডটি রেস্পন্সের জন্য রিকুএস্টটিকে sendRequestThroughRouter() নামের আরেকটি মেথডে পাঠিয়ে দেয়া হয়। আর যেখান থেকে bootstrappers গুলোকে boot করা হয়।

bootstrappers প্রপার্টিটির মধ্যে কিছু ক্লাস আছে যেগুলোকে লাইফসাইকেলের এ পর্যায়ে  boot করা হয়। তম্নধ্যে গুরুত্বপূর্র্ণ ২ টি ক্লাস হলো RegisterFacades, RegisterProviders. অর্থাৎ আমরা যে config/app.php তে এলিয়াস এবং প্রোভাইডারর্সের এরে দেখি, সেই ক্লাস গুলিই এখানে লোড হয়। আর রিউকুয়েস্ট হ্যান্ডেলের গুরুত্বপূর্র্ণ একটি প্রোভাইডার এখানে লোড হয় তা হলো RouteServiceProvider. আর এটিই আপনার রিকুয়েস্টকে web.php তে পাঠায়, আর যাত্রার পরের পথটা আপনারা অলরেডি চিনেন।

Wait.............

কন্ট্রোলার থেকে রিটার্ন করার পরেও কিছুটা পথ হয়তো অচেনা মনে হতে পারে। চলুন যাত্রার শেষ অবধি যাই।

কন্ট্রোলার থেকে যখন একটি রেস্পন্স পাঠানো হয়, রেস্পন্সটি রাউট মিডিলিয়ার এর মধ্যে দিয়ে বাহিরের দিকে ব্যাক করে। আর এটি রেস্পন্সটিকে পরিবর্র্তন ও পরীক্ষা করার একটু সুযগ প্রদান করে।

এবং ফাইনাল্লি রেসপন্সটি  একটি অবজেক্ট নিয়ে আবার index.php তে ফিরে আসে এবং index.php send() মেথড কল করার মাধ্যমে ভিজিটরের ব্রাউজারে কাঙ্খিত রেস্পনসটি দেখিয়ে তার যাত্রাটি এখানেই সমাপ্ত করে।

Request Lifecycle of Laravel Application

আমরা যখন লারাভেল এপ্লিকেশনে রিকুয়েষ্ট পাঠাই তখন প্রথমে এটা public folder এর index.php file টা লোড করে। এখানে তেমন একটা কোড থাকে না। এরপর এই ফাইল অটোলোড এর ফাইলগুলো কে লোড করে দেয় যেটা কিনা কম্পোজার দ্বারা জেনারেট করা হয়। একই সাথে এই ফাইল bootstrap/app.php এর একটা ইন্সট্যান্স তৈরি করে। এরপর লারাভেল নিজে তার এপ্লিকেশন এর একটা ইন্সট্যান্স তৈরি করে।

পরের ধাপে রিকুয়েষ্ট কে kenel এ পাঠানো হয়। এইটা হতে পারে app/Console/Kernel.php অথবা app/Http/Kernel.php এবং এটা নির্ভর করে রিকুয়েষ্ট এর ধরনের উপর। app/Http/Kernel.php রিকুয়েষ্ট রিসিভ করে এবং রেস্পন্স রিটার্ন করে। এই ফাইল এর মধ্যে এপ্লিকেশন এর সকল middleware ডিফাইন করা হয়ে থাকে।

পরের ধাপে Kernel এপ্লিকেশন এর সার্ভিস প্রভাইডার কে লোড করে। এই সার্ভিস প্রভাইডার গুলো config/app.php ফাইল এর মধ্যে রেজিস্টার করা হয়। সার্ভিস প্রভাইডার এর মধ্যে register মেথড আছে যেখানে প্রভাইডার কে রেজিস্টার করা হয় এবং boot মেথড এ সেগুলো এক্সিকিউট করা হয়।

এরপর রিকুয়েষ্ট কে Router এ পাঠানো হয়। কোন চেকিং করার কাজ থাকলে এটাকে middleware এর কাছে পাঠানো হয়। এরপর রাউট চাইলে এটাকে কলব্যাক ফাংশন এর মাধ্যমে হ্যান্ডেল করতে পারে অথবা রিকুয়েষ্ট কে কন্ট্রোলার এর মধ্যে পাস করে দিতে পারে। পরে কোন ভিউ বা রেসপন্স রিটার্ন করা হয়।