Search for a command to run...
تصویر /uploads/laravel jobs queue guide 3db1f2053bb1d3e90ed1.png در خیلی از اپلیکیشنهای Laravel، بخشی از کارها نباید همزمان با پاسخ HTTP انجام شوند؛ مثل ارسال…
Laravel محیط بسیار مناسبی برای پیادهسازی قابلیتهای هوش مصنوعی است؛ از تولید پیشنویس و خلاصهسازی تیکتها گرفته تا دستهبندی پیامهای پشتیبانی یا ساخت یک دستی…
در خیلی از اپلیکیشنهای Laravel، بخشی از کارها نباید همزمان با پاسخ HTTP انجام شوند؛ مثل ارسال ایمیل، پردازش تصویر، همگامسازی با API خارجی یا ساخت گزارش. اگر این کارها را داخل Controller نگه دارید، کاربر منتظر میماند و احتمال Timeout بالا میرود.
Laravel برای همین سناریو، سیستم Queue و کلاسهای Job را فراهم کرده است. در این مقاله قدمبهقدم میبینیم Job چیست، چطور ساخته میشود، چطور Dispatch میشود و چه نکاتی را در Production باید رعایت کنید.
یک Job واحد کاری است که میتواند بلافاصله یا با تأخیر، در پسزمینه اجرا شود. معمولاً منطق سنگین یا وابسته به سرویس خارجی را داخل Job میگذارید و از Request فقط آن را Dispatch میکنید.
مزیت اصلی این الگو:
قبل از شروع مطمئن شوید:
.env درایور Queue را مشخص کردهایددر فایل .env معمولاً یکی از این گزینهها را میبینید:
sync یعنی Job همان لحظه در همان Process اجرا میشود و برای Production مناسب نیست. برای شروع توسعه، database یا redis گزینههای رایجاند.
اگر از database استفاده میکنید، جدول jobs را بسازید:
با Artisan یک Job بسازید:
فایل معمولاً در مسیر app/Jobs/SendWelcomeEmail.php ساخته میشود. ساختار پایه چیزی شبیه این است:
اگر کلاس Job اینترفیس ShouldQueue را پیادهسازی کند، Laravel آن را به Queue میفرستد. بدون این اینترفیس، Job بهصورت همزمان (Synchronous) اجرا میشود.
از Controller، Listener یا Service میتوانید Job را Dispatch کنید:
جدا کردن صفها (مثلاً emails، reports، default) کمک میکند کارهای سنگین، کارهای سبک را بلوکه نکنند.
Job فقط وقتی اجرا میشود که Worker در حال گوشدادن به Queue باشد:
در Production معمولاً از Supervisor یا systemd استفاده میشود تا Worker بعد از Crash دوباره بالا بیاید و بعد از Deploy ریاستارت شود.
داخل خود Job میتوانید رفتار خطا را دقیقتر تعریف کنید:
برای دیدن Jobهای شکستخورده، جدول failed jobs را بسازید:
اینجا منطق ساخت گزارش داخل Service است و Job فقط orchestration میکند؛ این جداسازی تستپذیری و خوانایی را بهتر میکند.
QUEUE_CONNECTION=sync در Production و فکر کردن که Queue داریدqueue:work یا Supervisorfailed()برای نوشتن Job در Laravel این مسیر کافی است: Job بسازید، ShouldQueue را پیادهسازی کنید، منطق را در handle() بنویسید، با dispatch() ارسال کنید و Worker را اجرا نگه دارید. اگر کارهای پسزمینه را از Request جدا کنید، اپلیکیشن سریعتر، پایدارتر و مقیاسپذیرتر میشود.
Listener به Event واکنش نشان میدهد. اگر Listener اینترفیس ShouldQueue داشته باشد، خودش مثل یک Job صف میشود. Job را معمولاً مستقیم Dispatch میکنید؛ Listener را با Fire شدن Event.
وقتی چند Job مرتبط دارید و میخواهید پیشرفت، تکمیل یا شکست کل مجموعه را یکجا مدیریت کنید، Batch مناسب است.
بله. درایور database برای شروع کاملاً قابل استفاده است. برای حجم بالاتر، Redis معمولاً عملکرد بهتری میدهد.
مقالات بیشتری درباره توسعه وب، هوش مصنوعی، WordPress و فناوریهای مدرن را در وبلاگ بخوانید.
مرور مقالات
Skill چیست؟ Skill یک راهنمای Markdown است که Agent میتواند آن را پیدا کرده و در صورت نیاز اجرا کند. Skillها کاربردهای مختلفی دارند، از جمله: Workflowهای پروژه:…
تصویر /uploads/chgvnh cursor ra bh figm c473cb4ab0d7be477632.png چه چیزهایی نیاز دارید؟ برای شروع به موارد زیر نیاز دارید: Cursor با فعال بودن پلاگین Figma یا س…