Schedule Catchup: اجرای تسکهای جامونده لاراول بعد از قطعی
خلاصهٔ کاملتر
Schedule Catchup یه پکیج لاراول از Arowosaye Remilekun هست که یه مشکل قدیمی رو حل میکنه. اگه سرورت نیمهشب خاموش باشه، وقتی برمیگرده لاراول کامند نیمهشب رو اجرا نمیکنه. این پکیج فعالیت scheduler (یعنی همون زمانبند داخلی لاراول) رو تو دیتابیس ثبت میکنه و وقتی دوباره راه افتاد، نوبتهای جامونده رو پیدا میکنه.
همهچی خودکار replay نمیشه. باید روی تسک موردنظر متد replayOnCatchup() رو صدا بزنی:
Schedule::command('reports:daily')
->dailyAt('00:00')
->onOneServer()
->replayOnCatchup();به گفتهٔ مقاله، گزارشی که باید برای هر روز وجود داشته باشه گزینهٔ خوبیه. ولی یه poller که هر پنج دقیقه کارهای باقیمونده رو چک میکنه، از replay سود چندانی نمیبره. پکیج نوبتهای قبلی cron رو بررسی میکنه، اونایی که موفق یا تمومشده ثبت شدن رو کنار میذاره و بقیه رو از قدیمی به جدید اجرا میکنه. بار اول هم که هیچ checkpointی نداره، فقط یه نقطهٔ شروع ثبت میکنه و سراغ تاریخچهٔ نامعلوم نمیره.
یه دام مهم اینجاست: اگه کامندت تاریخ رو از now() حساب کنه، replay روز شنبه گزارش اشتباه میسازه. برای همین trait ResolvesScheduledTime متد scheduledFor() رو میده. موقع replay زمان همون نوبت جامونده رو برمیگردونه و تو اجرای عادی زمان فعلی رو. یعنی باید کامندهای وابسته به تاریخ رو دستی به این متد مهاجرت بدی، چون now() همچنان ساعت واقعی رو برمیگردونه. متد isCatchupReplay() هم هست اگه بخوای موقع ریکاوری رفتار متفاوتی داشته باشی.
سقف پیشفرض 50 نوبت برای هر تسکه. نسخهٔ 1.1.0 وقتی به این سقف برسه یه cursor ذخیره میکنه تا بقیه تو دورهای بعد اجرا بشن. تسکهای ناموفق تا max_attempts (پیشفرض سه بار) دوباره امتحان میشن. با گزینهٔ --dry-run کامند schedule-catchup:run هم میتونی قبل از اجرا ببینی چی قراره اجرا بشه. رویدادهای ScheduleCatchupCompleted و ScheduleCatchupFailed هم برای فرستادن نوتیفیکیشن هستن.
پکیج به PHP 8.2 به بالا نیاز داره و با لاراول 11، 12 و 13 کار میکنه. هر پنج دقیقه کامندهای catch-up و heartbeat رو اجرا میکنه و سابقه رو بعد از 90 روز پاک میکنه. نویسنده هشدار میده که اگه کامندی ایمیل بفرسته و قبل از ثبت موفقیت کرش کنه، retry ممکنه ایمیل رو دوباره بفرسته. پس کامندها باید idempotent باشن، یعنی اجرای دوبارهشون نتیجه رو خراب نکنه؛ مثلاً گزارش رو بر اساس تاریخ آپدیت کنی، نه اینکه یه ردیف تازه بسازی.
نکات کلیدی:
- فقط تسکهایی که replayOnCatchup() دارن بعد از قطعی دوباره اجرا میشن
- متد scheduledFor() از trait ResolvesScheduledTime تاریخ اصلی نوبت جامونده رو میده
- سقف پیشفرض 50 نوبت برای هر تسکه و retry تا سه بار انجام میشه
- نیازمند PHP 8.2+ و سازگار با لاراول 11، 12 و 13
- برای چند سرور باید کش مشترک برای mutexها و قفلهای پکیج تنظیم بشه




