NocoBase 0.16：全新的缓存模块

Posted on:2023年11月20日 at 19:59

新特性

之前版本的 cache 可用性较差（仅支持 memory 缓存），v0.16 版本进行了重构，内置了 memory 和 redis 两种 store（缓存存储方式），也支持自定义存储方式，具体的使用方法请参考 API 文档。

不兼容的变化

Node 最低版本更改为 18

Node v16 已经停止维护了，最低版本更改为 v18

{
  "engines": {
    "node": ">=18"
  }
}

创建缓存方法变更

以前创建缓存通过 createCache 方法创建，该方法已废弃。

import { createCache } from "@nocobase/cache";

const cache = createCache();

新的缓存由 CacheManager 统一管理，通过 app.cacheManager 创建。

const cache = await app.cacheManager.createCache({
  name: "memory", // 缓存唯一标识
  store: "memory", // 缓存方式
  // 其他缓存配置
  max: 2000,
  ttl: 60 * 1000,
});

环境变量变更

以前的缓存环境变量配置需要配置一个 JSON 字符串作为配置参数。

CACHE_CONFIG={"storePackage":"cache-manager-fs-hash","ttl":86400,"max":1000}

新的环境变量：

# 默认缓存方式，值为缓存方式的唯一标识
CACHE_DEFAULT_STORE=memory
# 内存缓存项目最大数量
CACHE_MEMORY_MAX=2000
# Redis，可选
CACHE_REDIS_URL=redis://localhost:6379

完整更新记录