Files
RSSHub/website/i18n/zh/docusaurus-plugin-content-docs/current/joinus/advanced/use-cache.md
T
dependabot[bot] 72f9a1f214 chore(deps): bump the docusaurus group in /website with 6 updates (#13668)
* chore(deps): bump the docs group in /website with 6 updates

Bumps the docs group in /website with 6 updates:

| Package | From | To |
| --- | --- | --- |
| [@docusaurus/core](https://github.com/facebook/docusaurus/tree/HEAD/packages/docusaurus) | `2.4.3` | `3.0.0` |
| [@docusaurus/plugin-client-redirects](https://github.com/facebook/docusaurus/tree/HEAD/packages/docusaurus-plugin-client-redirects) | `2.4.3` | `3.0.0` |
| [@docusaurus/plugin-pwa](https://github.com/facebook/docusaurus/tree/HEAD/packages/docusaurus-plugin-pwa) | `2.4.3` | `3.0.0` |
| [@docusaurus/preset-classic](https://github.com/facebook/docusaurus/tree/HEAD/packages/docusaurus-preset-classic) | `2.4.3` | `3.0.0` |
| [@docusaurus/module-type-aliases](https://github.com/facebook/docusaurus/tree/HEAD/packages/docusaurus-module-type-aliases) | `2.4.3` | `3.0.0` |
| [@docusaurus/types](https://github.com/facebook/docusaurus/tree/HEAD/packages/docusaurus-types) | `2.4.3` | `3.0.0` |


Updates `@docusaurus/core` from 2.4.3 to 3.0.0
- [Release notes](https://github.com/facebook/docusaurus/releases)
- [Changelog](https://github.com/facebook/docusaurus/blob/main/CHANGELOG.md)
- [Commits](https://github.com/facebook/docusaurus/commits/v3.0.0/packages/docusaurus)

Updates `@docusaurus/plugin-client-redirects` from 2.4.3 to 3.0.0
- [Release notes](https://github.com/facebook/docusaurus/releases)
- [Changelog](https://github.com/facebook/docusaurus/blob/main/CHANGELOG.md)
- [Commits](https://github.com/facebook/docusaurus/commits/v3.0.0/packages/docusaurus-plugin-client-redirects)

Updates `@docusaurus/plugin-pwa` from 2.4.3 to 3.0.0
- [Release notes](https://github.com/facebook/docusaurus/releases)
- [Changelog](https://github.com/facebook/docusaurus/blob/main/CHANGELOG.md)
- [Commits](https://github.com/facebook/docusaurus/commits/v3.0.0/packages/docusaurus-plugin-pwa)

Updates `@docusaurus/preset-classic` from 2.4.3 to 3.0.0
- [Release notes](https://github.com/facebook/docusaurus/releases)
- [Changelog](https://github.com/facebook/docusaurus/blob/main/CHANGELOG.md)
- [Commits](https://github.com/facebook/docusaurus/commits/v3.0.0/packages/docusaurus-preset-classic)

Updates `@docusaurus/module-type-aliases` from 2.4.3 to 3.0.0
- [Release notes](https://github.com/facebook/docusaurus/releases)
- [Changelog](https://github.com/facebook/docusaurus/blob/main/CHANGELOG.md)
- [Commits](https://github.com/facebook/docusaurus/commits/v3.0.0/packages/docusaurus-module-type-aliases)

Updates `@docusaurus/types` from 2.4.3 to 3.0.0
- [Release notes](https://github.com/facebook/docusaurus/releases)
- [Changelog](https://github.com/facebook/docusaurus/blob/main/CHANGELOG.md)
- [Commits](https://github.com/facebook/docusaurus/commits/v3.0.0/packages/docusaurus-types)

---
updated-dependencies:
- dependency-name: "@docusaurus/core"
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: docs
- dependency-name: "@docusaurus/plugin-client-redirects"
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: docs
- dependency-name: "@docusaurus/plugin-pwa"
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: docs
- dependency-name: "@docusaurus/preset-classic"
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: docs
- dependency-name: "@docusaurus/module-type-aliases"
  dependency-type: direct:development
  update-type: version-update:semver-major
  dependency-group: docs
- dependency-name: "@docusaurus/types"
  dependency-type: direct:development
  update-type: version-update:semver-major
  dependency-group: docs
...

Signed-off-by: dependabot[bot] <support@github.com>

* chore: fix dependencies

* docs: fix admonition

caution is deprecated in v3

caution(v2 yellow) => warning(v3 yellow)

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2023-11-01 23:24:57 +08:00

4.7 KiB

sidebar_position
sidebar_position
3

使用缓存

所有路由都有一个缓存,该缓存在短时间后过期。您可以通过环境变量来修改 lib/config.js 文件中的 CACHE_EXPIRE 值使用来更改缓存的持续时间。然而,对于那些内容更新较少的接口,最好是使用 CACHE_CONTENT_EXPIRE 来指定较长的缓存过期时间。

例如,为了获取每个 GitHub Issue 的第一个评论的正文,您可以向 ${baseUrl}/${user}/${repo}/issues/${id} 发出请求,因为 ${baseUrl}/${user}/${repo}/issues 无法提供此数据。推荐将此数据存储在缓存中,以避免重复向服务器发出请求。

以下是如何使用缓存获取数据的示例代码:

    const items = await Promise.all(
        list.map((item) =>
            ctx.cache.tryGet(item.link, async () => {
                const { data: response } = await got(item.link);
                const $ = cheerio.load(response);

                item.description = $('.comment-body').first().html();

                return item;
            })
        )
    );

以上代码片段来自 制作自己的 RSSHub 路由,展示了如何使用缓存获取每个问题的第一个评论的全文。使用 ctx.cache.tryGet() 来确定数据是否已经在缓存中。如果不在,则代码会获取数据并将其存储在缓存中。

上一个语句返回的对象将被重复使用,并且会添加一个额外的 description 属性。每个 item.link 的返回缓存将是{ title, link, pubDate, author, category, description }。下一次请求相同路由时,将直接返回处理过后的缓存而不是向服务器发出请求并重新计算数据。

:::warning

在 tryGet() 函数之外声明的变量的任何赋值都不会在缓存命中的情况下被处理。例如,以下代码将无法按预期工作:

    let x = '1';
    const z = await ctx.cache.tryGet('cache:key', async () => {
        x = '2';
        const y = '3';
        return y;
    })
    console.log(x); // 缓存未命中: '2', 缓存命中: '1'
    console.log(z): // '3'

:::

API

ctx.cache.tryGet(key, getValueFunc [, maxAge [, refresh ]])

参数

名称 类型 描述
key string (必填) 用于存储和获取缓存的键。您可以使用 : 作为分隔符创建层次结构。
getValueFunc function | string (必填) 当发生缓存未命中时返回要缓存的数据的函数。
maxAge number (可选) 缓存的最大过期时间(以秒为单位)。如果没有指定,将使用 CACHE_CONTENT_EXPIRE。
refresh boolean (可选) 是否在缓存命中时更新缓存过期时间。默认为 true。

定义在

lib/middleware/cache/index.js

:::tip

以下是使用缓存的高级方法。大多数情况下,您应使用 ctx.cache.tryGet()。

请注意,当使用 ctx.cache.get() 获取缓存时,您需要使用 JSON.parse()。

:::

ctx.cache.get(key [, refresh ])

参数

名称 类型 描述
key string (必填) 用于检索缓存的键。您可以使用 : 作为分隔符创建层次结构。
refresh boolean (可选) 是否在缓存命中时更新缓存过期时间。默认为true。

ctx.cache.set(key, value [, maxAge ])

参数

名称 类型 描述
key string (必填) 用于存储缓存的键。您可以使用:作为分隔符创建层次结构。
value function| string (必填) 要缓存的值。
maxAge number (可选) 缓存的最大过期时间 (以秒为单位)。如果没有指定,将使用 CACHE_CONTENT_EXPIRE。