Gestionnaire de cache personnalisé pour Next.js

Vous pouvez configurer l'emplacement du cache Next.js si vous souhaitez persister les pages et données en cache dans un stockage durable, ou partager le cache entre plusieurs conteneurs ou instances de votre application Next.js.

next.config.js
module.exports = {
  cacheHandler: require.resolve('./cache-handler.js'),
  cacheMaxMemorySize: 0, // désactive le cache en mémoire par défaut
}

Consultez un exemple de gestionnaire de cache personnalisé et apprenez-en plus sur son implémentation.

Référence API

Le gestionnaire de cache peut implémenter les méthodes suivantes : get, set, revalidateTag et resetRequestCache.

get()

ParamètreTypeDescription
keystringLa clé de la valeur en cache.

Retourne la valeur en cache ou null si non trouvée.

set()

ParamètreTypeDescription
keystringLa clé sous laquelle stocker les données.
dataData ou nullLes données à mettre en cache.
ctx{ tags: [] }Les étiquettes de cache fournies.

Retourne Promise<void>.

revalidateTag()

ParamètreTypeDescription
tagstring ou string[]Les étiquettes de cache à revalider.

Retourne Promise<void>. Apprenez-en plus sur la revalidation des données ou la fonction revalidateTag().

resetRequestCache()

Cette méthode réinitialise le cache temporaire en mémoire pour une seule requête avant la prochaine requête.

Retourne void.

Bon à savoir :

  • revalidatePath est une couche de commodité au-dessus des étiquettes de cache. Appeler revalidatePath appellera votre fonction revalidateTag, que vous pouvez ensuite choisir d'utiliser pour étiqueter les clés de cache en fonction du chemin.

Support des plateformes

Option de déploiementSupporté
Serveur Node.jsOui
Conteneur DockerOui
Export statiqueNon
AdaptateursDépend de la plateforme

Apprenez comment configurer ISR lors de l'hébergement autonome de Next.js.

Historique des versions

VersionChangements
v14.1.0Renommé en cacheHandler et devenu stable.
v13.4.0Prise en charge de revalidateTag pour incrementalCacheHandlerPath.
v13.4.0Prise en charge de la sortie autonome pour incrementalCacheHandlerPath.
v12.2.0Ajout expérimental de incrementalCacheHandlerPath.

On this page