Redis-payload NPM

Payload Redis Cache Plugin

This plugin for Payload CMS adds a cache layer to API endpoints. The cache is based on the combination of the user's collection and the original URL.

Requirements

Payload version 1.0.19 or higher is required
A Redis instance is required

Installation

To install the plugin, run one of the following commands:

yarn add redis-payload

npm install redis-payload

Redis package

You also need to install the redis package if it is not already installed:

yarn add redis

npm install redis

Usage

To use the plugin, add it to the Payload config as follows:

import { buildConfig } from 'payload/config';
import { cachePlugin } from 'redis-payload'

const config = buildConfig({
  // your config here
  
  plugins: [
    cachePlugin({ 
      excludedCollections: ['users'],
      //  excludedGlobals: ['myglobal']
    })
  ]
})

Add the initializer function in server.ts

import { cachePlugin } from 'redis-payload'

...

initRedis({
  redisUrl: process.env.REDIS_URI
})

Plugin options

Option	Type	Description
`redisUrl` *	`string`	Redis instance's url.
`redisNamespace`	`string`	Choose the prefix to use for cache redis keys. Defaults to `payload`.
`redisIndexesName`	`string`	Choose the index key for cache redis indexes. Defaults to `payload-cache-index`.
`excludedCollections`	`string[]`	An array of collection names to be excluded.
`excludedGlobals`	`string[]`	An array of globals names to be excluded.
`includedPaths`	`string[]`	An array of custom routes to be included.

A * denotes that the property is required.

Helpers

This package provides utility functions for managing the cache. Here's an example of how to use the invalidateCache function:

import { invalidateCache }  from '@aengz/payload-redis-cache'

...

invalidateCache()

Development

There is a development environment in the /dev directory of the repository. To use it, create a new .env file in the /dev directory using the example .env.example file as a reference: