绑定

绑定 (opens in a new tab) 允许您的 Worker 与 Cloudflare 开发者平台上的资源进行交互。当您在 Worker 上声明绑定时，您授予它特定的能力，例如能够向 R2 (opens in a new tab) 存储桶读写文件。

如何配置您的 Next.js 应用以便访问绑定

安装 @opennextjs/cloudflare (opens in a new tab)，然后在您的 Next.js 应用的根目录中添加一个 wrangler 配置文件 (opens in a new tab)，如 入门指南 中所述。

如何在您的 Next.js 应用中访问绑定

您可以通过 getCloudflareContext 从 Next.js 应用的任何路由访问 绑定 (opens in a new tab)：

import { getCloudflareContext } from "@opennextjs/cloudflare";
 
export async function GET(request) {
  let responseText = "Hello World";
 
  const myKv = (await getCloudflareContext()).env.MY_KV_NAMESPACE;
  await myKv.put("foo", "bar");
  const foo = await myKv.get("foo");
 
  return new Response(foo);
}

如何向您的 Worker 添加绑定

通过将绑定添加到您的 wrangler 配置文件 (opens in a new tab) 来向您的 Worker 添加绑定。

绑定的 TypeScript 类型声明

为了确保上述 (await getCloudflareContext()).env 中的 env 对象具有准确的 TypeScript 类型，请运行以下 Wrangler 命令以 生成与您的 Worker 配置匹配的类型 (opens in a new tab)：

npx wrangler types --experimental-include-runtime

这将生成一个 d.ts 文件并（默认情况下）将其保存到 .wrangler/types/runtime.d.ts。命令的输出中将提示您将该文件添加到 tsconfig.json 的 compilerOptions.types 数组中。

如果您希望将该文件提交到 git，您可以提供一个自定义路径。例如，此处 runtime.d.ts 文件将保存到项目的根目录：

npx wrangler types --experimental-include-runtime="./runtime.d.ts"

为了确保您的类型始终是最新的，请在配置文件发生任何更改后运行 wrangler types --experimental-include-runtime。

其他 Cloudflare API（cf, ctx）

您可以从 cf 对象 (opens in a new tab) 访问有关传入请求的上下文，以及从 getCloudflareContext() (opens in a new tab) 的返回值中的 ctx 对象 (opens in a new tab) 访问生命周期方法：

import { getCloudflareContext } from "@opennextjs/cloudflare";
 
export async function GET(request) {
  const { env, cf, ctx } = await getCloudflareContext();
 
  // ...
}