تسريع API لارافيل بالـ Redis cache
خزّن القراءات المتكررة مثل الكتالوج دقائق قليلة عبر Cache::remember، وأبطل المفتاح عند تعديل الصنف. لا تخزّن نتيجة التحقق من سيريتل كاش أو شام كاش ولا حالة الطلب بعد الدفع. Redis يبقى على شبكة خاصة بكلمة مرور.
أول API لارافيل ربطته بمتجر سوري كان يعيد بناء قائمة الأصناف من قاعدة البيانات في كل طلب، حتى عندما لم يتغيّر سعر واحد طوال الساعة. في ساعة الذروة صارت الصفحة أبطأ من أن ينتظر الزبون السلة. نقلت القراءات الثقيلة إلى Redis، وأبقيت كتابة الطلب وحالة الدفع على قاعدة البيانات. السرعة جاءت من معرفة ماذا يُخزَّن، ومتى يُبطَل، وما الذي لا يجوز أن يعيش في الكاش أصلًا.
هذا المقال عن كاش القراءة في لارافيل. تحديد معدل الطلبات (rate limiting) بـ Redis موضوع منفصل، ومشروح بالإنكليزية في Rate limiting a Node.js API with Redis. ربط الدفع نفسه، بما فيه المطابقة على رقم العملية والمبلغ، مشروح في بوابة سيريتل كاش وشام كاش مع Laravel.
ماذا تخزّن، وماذا تترك خارج الكاش
أخزّن ما يُقرأ كثيرًا ويتغيّر قليلًا: قائمة الأصناف مع الأسعار، إعدادات المتجر الظاهرة للزبون، وساعات العمل. مدة قصيرة تكفي، من دقيقة إلى بضع دقائق حسب كم مرة تتبدل القائمة في يومك.
لا أخزّن نتيجة التحقق من دفعة سيريتل كاش أو شام كاش. التحويل قد يظهر بعد ثوانٍ، والمبلغ يجب أن يُقارن مع الطلب الحي، ورقم العملية يُحفظ بقيد فريد. وضع هذه النتيجة في Redis دقيقة كاملة يعني أن زبونًا يلصق رقمًا لم يظهر بعد فيبقى «غير موجود» رغم أن البوابة صارت تراه. التحويل ما فيه حقل ملاحظة، والمطابقة تتم على رقم العملية والمبلغ في اللحظة، مع حفظ رقم المرسل كمعلومة إضافية لا كشرط.
لا أخزّن أيضًا رصيد المحفظة ولا رد ويب هوك. قبول الحدث مرة واحدة يعود إلى سجل الأحداث في قاعدتك، كما في Reliable payment webhooks، لا إلى مفتاح كاش قد يُحذف.
Cache::remember بمفتاح واضح
في لارافيل أبدأ بتعريف Redis كمخزن افتراضي للكاش في config/cache.php، ثم أغلف القراءة الثقيلة بـ Cache::remember. المفتاح يتضمّن ما يغيّر الناتج: الفرع، اللغة، وإصدار القائمة إن وُجد.
```php <?php
namespace App\Http\Controllers;
use App\Models\Product; use Illuminate\Http\JsonResponse; use Illuminate\Support\Facades\Cache;
class CatalogController { public function index(): JsonResponse { $branchId = (int) request('branch_id', 1);
$catalog = Cache::remember( "catalog:branch:{$branchId}", now()->addMinutes(2), function () use ($branchId) { return Product::query() ->where('branch_id', $branchId) ->where('is_active', true) ->orderBy('sort_order') ->get(['id', 'name', 'price', 'category']) ->all(); } );
return response()->json(['data' => $catalog]); } } ```
دقيقتان ليست رقمًا سحريًا. قائمة مطعم تتبدل عند نفاد طبق تحتاج مدة أقصر، أو إبطالًا يدويًا عند الحفظ. كتالوج يُحدَّث مرة في اليوم يتحمل مدة أطول. المهم أن المفتاح لا يخلط فرعين، وأن السعر داخل الكاش هو السعر الذي تبيعه الآن لا سعر الأمس.
بعد تعديل صنف أو إيقافه، أبطل المفتاح صراحة بدل انتظار انتهاء المدة:
```php use Illuminate\Support\Facades\Cache;
public function updated(Product $product): void { Cache::forget("catalog:branch:{$product->branch_id}"); } ```
إذا كان عندك أكثر من شكل للقائمة (عربية وإنكليزية، أو قائمة مختصرة للتطبيق)، امسح كل المفاتيح المرتبطة بالفرع، أو استخدم وسمًا (Cache::tags) إن كان المخزن يدعم الوسوم على Redis. من دون الإبطال، البوت أو التطبيق يعرض طبقًا نافدًا دقيقتين، وهذا أهون من عرض سعر قديم طوال ساعة، لكنه يبقى خطأ إن كان المطعم يعتمد على الإيقاف الفوري.
أخطاء أكرر التنبيه عليها
مفتاح عام لكل الزبائن وفيه بيانات طلب واحد. كاش القائمة مشترك. كاش «طلب المستخدم 15» يجب أن يحمل معرّف الطلب والمستخدم، أو ألا يُستخدم أصلًا إذا كانت الصفحة تُقرأ مرة واحدة بعد الدفع.
تخزين كائنات Eloquent مع علاقات ثقيلة ثم اكتشاف أن التسلسل كسر علاقة بعد إعادة التشغيل. أنا أخزّن مصفوفة حقول محددة كما في المثال، لا النموذج كاملًا.
إبقاء Redis بلا كلمة مرور وعلى منفذ مفتوح للإنترنت. الكاش هنا فيه أسعار وقوائم، وأحيانًا ما هو أسوأ إذا أخطأ أحد وخزّن توكنًا. Redis يبقى على شبكة خاصة أو على نفس السيرفر. مسار النشر الذي أستخدمه لخدمة خلف Nginx موجود في نشر مشروع Node.js على VPS، وفكرة العزل نفسها تنطبق على PHP-FPM ولارافيل.
الكاش كبديل عن الفهرس في قاعدة البيانات. إذا كانت قائمة الأصناف بطيئة لأن الاستعلام يمسح الجدول بلا index على branch_id، Redis يخفي المشكلة إلى أن تسقط العقدة. أصلح الاستعلام أولًا، ثم ضع الكاش فوقه.
حالة الطلب بعد الدفع لا تُخزَّن مدة طويلة. صفحة «هل دُفع طلبك؟» يجب أن تقرأ الصف الحي، لأن التاجر والزبون ينتظران تغيّرًا في ثوانٍ. إن وضعت كاشًا قصيرًا جدًا لتخفيف الضغط، ابطله فور نجاح المطابقة في نفس العملية التي تحفظ «مدفوع».
إذا انتهت صلاحية مفتاح القائمة في ساعة ذروة، عشرات الطلبات قد تعيد الاستعلام معًا. في هذه الحالة أستخدم قفلًا قصيرًا حول البناء (Cache::lock) حتى تبني نسخة واحدة ويقرأ الباقي النتيجة. لا تضع هذا القفل حول استعلام بوابة الدفع؛ التحقق من رقم العملية يبقى طلبًا مباشرًا في وقته.
قائمة تحقق قبل التشغيل
CACHE_STORE=redisفي البيئة الحية، وREDIS_PASSWORDموجود، والمنفذ غير منشور للعالم.- مفاتيح القائمة تتضمن الفرع وأي بعد آخر يغيّر الناتج.
- حفظ صنف أو إيقافه يبطل المفاتيح المتعلقة به.
- مسار تأكيد الدفع بسيريتل كاش أو شام كاش لا يقرأ نتيجة التحقق من الكاش. المطابقة على رقم العملية والمبلغ، والقيد الفريد على رقم العملية يبقى في قاعدة البيانات.
- تجربة بسيطة: اطلب القائمة مرتين، والثانية لا تعيد الاستعلام الثقيل. عدّل سعرًا، والطلب التالي يظهر السعر الجديد.
أسئلة تتكرر
هل أضع كاشًا أمام كل مسار في routes/api.php؟
لا. المسارات التي تقرأ قائمة أو إعدادات تستفيد. مسار إنشاء الطلب، ومسار لصق رقم العملية، ومسار الويب هوك، تبقى بلا كاش للنتيجة. إذا أبطأت هذه المسارات، السبب غالبًا في الاستعلام أو في مهلة الشبكة، لا في غياب Redis.
هل Redis على نفس السيرفر يكفي؟
لمتجر واحد أو فرعين، نعم غالبًا. افصله في عملية مستقلة حتى لا يمسح إعادة نشر لارافيل البيانات، وخذ نسخة احتياطية إن كنت تستخدمه لشيء أطول عمرًا من قائمة قصيرة. للكاش وحده، ضياع البيانات عند إعادة التشغيل مقبول إذا كان الإبطال والمدة مضبوطين.
ماذا عن جلسات لارافيل في Redis؟
ممكن، وهو مفيد إن كان عندك أكثر من نسخة PHP. لا تخلط مفاتيح الجلسات مع مفاتيح القائمة بلا بادئة. جلسة المستخدم ليست كتالوجًا، وعمرها مختلف.
هل الكاش يغني عن بوابة الدفع؟
لا. البوابة تبحث عن التحويل. سيريتل كاش دولاران للرقم في الشهر، وشام كاش خمسة دولارات للحساب، والإعداد في اليوم نفسه من دون تسليم كود البوابة. الكاش يسرّع قراءة قائمتك، لا تأكيد الدفعة.
إذا بدك API لارافيل أسرع، أو بوابة سيريتل كاش وشام كاش تتصل به، راسلني من صفحة الموقع أو على fayezalshami.dev@gmail.com. اذكر حجم القائمة، وعدد الفروع، وهل الدفع يتم اليوم يدويًا أم عبر طلب إلى بوابة.