Адаптеры кэша и KV для Payload CMS 4

KV-хранилище Payload CMS можно вынести из основной базы данных. Адаптеры для Redis, Upstash и Cloudflare Workers KV подключаются через опцию kv.

Хранит key-value данные Payload в Redis через API payload.kv

Хранит key-value данные Payload в Upstash Redis с префиксами ключей и правилами истечения

Добавляет хранилище «ключ-значение» Cloudflare Workers KV в API kv для Payload

Хранит внутренние данные key-value Payload в пространстве имён Cloudflare KV

Об этих пакетах

KV-адаптер даёт Payload отдельное key-value хранилище. Его настраивают в опции kv в payload.config. Без адаптера Payload хранит эти данные в основной базе.

Что входит в категорию

  • Официальный адаптер Redis для данных, общих для нескольких инстансов
  • Upstash Redis с префиксами ключей и сроком жизни записей
  • Адаптеры Cloudflare KV, которые хранят значения в пространстве имён Workers KV

Как выбрать KV-адаптер

Официальный адаптер Redis берите, если Redis уже работает рядом с приложением. Он подходит и тогда, когда одни и те же данные нужны нескольким инстансам. Upstash выручит серверлесс-деплои, которые не могут держать постоянное соединение. На Cloudflare Workers выбирайте пакет Cloudflare KV по версии Payload. Один рассчитан на бету Payload 4, другой на Payload 3. Кэширование ответов и сброс кэша Next.js решают другую задачу, их дают плагины кэширования.

Частые вопросы

Что делает KV-адаптер в Payload CMS?

Он заменяет стандартное key-value хранилище в базе данных на отдельное. Адаптер один раз указывают в опции kv, и дальше Payload читает и пишет KV-данные через него.

Нужен ли Redis, чтобы запустить Payload?

Нет. Payload работает и без KV-адаптера. Добавьте его, если хотите вынести KV-данные из основной базы или сделать их общими для нескольких инстансов.

Какой KV-адаптер работает на серверлесс-платформах?

Upstash и Cloudflare KV обращаются к своим хранилищам по HTTP или через биндинг платформы. Долгоживущее соединение им не нужно, а это подходит для серверлесс- и edge-рантаймов.