برمجة

Laravel lazyById: حدّث السجلات أثناء المرور عليها دون تخطي دفعات

فريق فايندو جروب2 دقائق قراءة0 مشاهدة0 تعليقات
مشاركة:
حاسوب محمول يعرض كود PHP وجدول سجلات جرت معالجتها

لديك عملية تنقل العملاء من «بانتظار المراجعة» إلى «تمت المراجعة». إذا كانت كل دفعة تقرأ القائمة باستخدام إزاحة ثم تغيّر حالة العناصر نفسها، تنكمش مجموعة النتائج قبل القراءة التالية. قد تنتهي المهمة دون خطأ، ومع ذلك تظل عناصر لم تمر عليها. المشكلة هنا في طريقة تقسيم المجموعة المتغيرة.

متى تختار lazyById؟

توثيق Laravel 12 يوصي بـ lazyById أو lazyByIdDesc عند تحديث السجلات أثناء قراءتها؛ فالانتقال يعتمد على المفتاح بدل الإزاحة. يجب ألا تغيّر المفتاح المستخدم للمرور أثناء المعالجة. وتحتاج شروط OR إلى تجميع منطقي لأن الدالة تضيف شروطها على المعرف. هذه الآلية لا تمنح المهمة تلقائيًا قفلًا عامًا أو ضمان تنفيذ الأثر مرة واحدة.

ثبّت نطاق تشغيل واضحًا

هذا مثال تعليمي لجدول اختبار اسمه review_items. يأخذ حدًا أعلى للمعرفات كي لا يتحول التشغيل إلى مطاردة عناصر جديدة تُضاف باستمرار. فحص الحالة مرة أخرى عند التحديث يمنع الكتابة فوق عنصر خرج من الحالة المنتظرة قبل تنفيذ التحديث.

$limit = DB::table('review_items')->max('id');
DB::table('review_items')
->where('status', 'pending')
->where('id', '<=', $limit)
->lazyById(100)
->each(function ($row) {
DB::table('review_items')
->where('id', $row->id)
->where('status', 'pending')
->update(['status' => 'reviewed']);
});

اختبار يكشف التخطي

جهّز 250 عنصرًا افتراضيًا بالحالة المنتظرة، وسجل معرفاتها في ملف اختبار قبل البدء. شغّل دفعات من 100، ثم قارن مجموعة المعرفات المتوقعة مع التي تغيرت بالفعل. لا تكتفِ برسالة «اكتملت المهمة» أو بعدد مرات استدعاء الدالة. أضف عنصرًا جديدًا بعد التقاط الحد الأعلى؛ ينبغي أن يبقى خارج هذا التشغيل وفق السياسة المعلنة.

أعد الاختبار مع عنصر جرى اعتماده يدويًا أثناء التشغيل. المطلوب ألا تعيده المهمة إلى حالة أخرى أو تسجل اعتمادًا ثانيًا له. ثم أوقف العامل بين دفعتين وأعد التشغيل؛ راقب هل يتجاوز ما اكتمل بالفعل وهل تظل العناصر المتبقية قابلة للمعالجة.

الآثار الخارجية تحتاج عقدًا آخر

إذا أرسلت كل مراجعة بريدًا أو طلبًا لخدمة خارجية، فنجاح تحديث الحالة ليس برهانًا على نجاح الإرسال. حدد سجلًا للأثر ومعرفًا يمنع تكراره وسياسة إعادة محاولة مستقلة. سلّم للفريق تقريرًا بالمعرفات الناجحة والمتجاوزة والفاشلة، وسبب كل فشل، بدل إعادة الدفعة كلها اعتمادًا على الظن.

المراجع والخطوة التالية

يمكن تطبيق هذه المراجعة ضمن تطوير CRM ومراجعة استعلامات Laravel. الأمثلة تعليمية، والصورة مشهد تقني توضيحي مولد بالذكاء الاصطناعي وليست لقطة من مشروع عميل.

التصنيفات:برمجة
شارك:

التعليقات

لا توجد تعليقات بعد

أضف تعليقك

كن أول من يعلق على هذا المقال

02 · تابع القراءة

مقالات ذات صلة