معالج ذاكرة التخزين المؤقت المخصص في Next.js

يمكنك تكوين موقع ذاكرة التخزين المؤقت لـ Next.js إذا كنت ترغب في الحفاظ على الصفحات والبيانات المخزنة مؤقتًا في تخزين دائم، أو مشاركة الذاكرة المؤقتة عبر عدة حاويات أو نسخ من تطبيق Next.js الخاص بك.

next.config.js
module.exports = {
  cacheHandler: require.resolve('./cache-handler.js'),
  cacheMaxMemorySize: 0, // تعطيل التخزين المؤقت في الذاكرة الافتراضي
}

عرض مثال لـ معالج ذاكرة تخزين مؤقت مخصص ومعرفة المزيد حول التنفيذ.

مرجع API

يمكن لمعالج الذاكرة المؤقتة تنفيذ الطرق التالية: get، set، revalidateTag، و resetRequestCache.

get()

المعاملالنوعالوصف
keystringالمفتاح للقيمة المخزنة مؤقتًا.

تُرجع القيمة المخزنة مؤقتًا أو null إذا لم يتم العثور عليها.

set()

المعاملالنوعالوصف
keystringالمفتاح لتخزين البيانات تحته.
dataData أو nullالبيانات المراد تخزينها مؤقتًا.
ctx{ tags: [] }علامات الذاكرة المؤقتة المقدمة.

تُرجع Promise<void>.

revalidateTag()

المعاملالنوعالوصف
tagstring أو string[]علامات الذاكرة المؤقتة لإعادة التحقق منها.

تُرجع Promise<void>. تعرف على المزيد حول إعادة التحقق من البيانات أو دالة revalidateTag().

resetRequestCache()

هذه الطريقة تعيد ضبط الذاكرة المؤقتة المؤقتة في الذاكرة لطلب واحد قبل الطلب التالي.

تُرجع void.

معلومة مفيدة:

  • revalidatePath هي طبقة راحة فوق علامات الذاكرة المؤقتة. استدعاء revalidatePath سيستدعي دالة revalidateTag الخاصة بك، والتي يمكنك بعد ذلك اختيار ما إذا كنت تريد وضع علامة على مفاتيح الذاكرة المؤقتة بناءً على المسار.

دعم المنصة

خيار النشرمدعوم
خادم Node.jsنعم
حاوية Dockerنعم
تصدير ثابتلا
المحولاتحسب المنصة

تعرف على كيفية تكوين ISR عند استضافة Next.js ذاتيًا.

سجل الإصدارات

الإصدارالتغييرات
v14.1.0تمت إعادة تسميته إلى cacheHandler وأصبح مستقرًا.
v13.4.0دعم incrementalCacheHandlerPath لـ revalidateTag.
v13.4.0دعم incrementalCacheHandlerPath للإخراج المستقل.
v12.2.0تمت إضافة incrementalCacheHandlerPath تجريبيًا.