Durable Workflow: کارهای چندمرحلهای ماندگار در لاراول
خلاصهٔ کاملتر
Durable Workflow یه پکیج رایگان و متنباز لاراوله که Richard McDaniel ساخته. کارش اینه که پروسههای پسزمینهی چندمرحلهای، پیشرفتشون رو حتی بعد از ریاستارت شدن ورکر حفظ کنن. مثال مقاله یه گزارشه که باید ساخته بشه، آپلود بشه و بعد برای مشتری ایمیل بشه. اگه ورکر بعد از آپلود بخوابه، این پکیج میدونه کدوم مرحلهها تموم شدن و از همونجا ادامه میده.
همهچیز داخل خود اپلیکیشن اجرا میشه: دیتابیس خودت تاریخچهی اجرا رو نگه میداره، صفهای لاراول کار رو انجام میدن و کش برای lock (یعنی قفلی که جلوی اجرای همزمان یه کار رو میگیره) استفاده میشه. درایورهای database، Redis و Amazon SQS پشتیبانی میشن، ولی درایور sync نه، چون صف باید async باشه. کش هم باید از lock پشتیبانی کنه. یه سرویس Cloud پولی هم هست، ولی اجباری نیست.
پکیج دو مفهوم رو از هم جدا میکنه: workflow که ترتیب مرحلهها رو هماهنگ میکنه، و activity که کار واقعی مثل ساخت فایل یا صدا زدن یه API بیرونی رو انجام میده. workflow گزارش تو مقاله این شکلیه:
public function handle(int $reportId): string
{
$path = activity(GenerateReport::class, $reportId);
$url = activity(UploadReport::class, $reportId, $path);
activity(NotifyReportReady::class, $reportId, $url);
return $url;
}وقتی workflow دوباره راه میافته، کد PHPش replay میشه، یعنی از اول اجرا میشه ولی برای activityهایی که نتیجهشون ثبت شده، همون نتیجهی ذخیرهشده برمیگرده و کار دوباره انجام نمیشه. نویسنده هشدار میده که اگه ورکر یه کار رو انجام بده ولی قبل از ثبت نتیجه بخوابه، اون activity ممکنه دوباره اجرا بشه. پس activityها باید تکرارپذیر و بیخطر باشن، مثلاً آپلود روی یه کلید ثابت.
تو نسخهی v2، activityها بهطور پیشفرض فقط یه بار اجرا میشن و retry باید با $tries و backoff() فعال بشه. خوندن از دیتابیس و صدا زدن سرویسهای بیرونی باید داخل activity باشه، چون کد workflow موقع replay باید همون تصمیمها رو بگیره. پکیج signal هم داره، یعنی میشه به یه workflow در حال اجرا ورودی فرستاد (مثلاً تأیید یه آدم)، بهعلاوهی تایمرهای ماندگار و timeout برای انتظار.
نویسنده میگه برای یه کار سادهی تکی، همون job معمولی لاراول کافیه و این پکیج وقتی بهدرد میخوره که پروسه چند مرحله داره یا باید منتظر ورودی بیرونی بمونه.
نکات کلیدی:
- نسخهی 2.28.1 به Laravel 12.72+ یا 13.41+ و PHP 8.2+ (برای Laravel 13 نسخهی 8.3+) نیاز داره.
- درایور صف sync پشتیبانی نمیشه و کش باید lock داشته باشه.
- activityها تو v2 بهطور پیشفرض retry ندارن و باید با $tries تنظیم بشن.
- یه activity ممکنه بیشتر از یه بار اجرا بشه، پس باید تکرارپذیر طراحی بشه.
- استفاده از پکیج رایگانه و سرویس Cloud پولیش اختیاریه.




