Nitro 集成
Better Auth 可以与您的 Nitro 应用程序 集成（一个用于构建 Web 服务器的开源框架）。
本指南旨在通过几个简单步骤帮助您将 Better Auth 与您的 Nitro 应用程序集成。
创建新的 Nitro 应用程序
通过运行以下命令来搭建一个新的 Nitro 应用程序：
npx giget@latest nitro nitro-app --install这将创建 nitro-app 目录并安装所有依赖项。您现在可以在代码编辑器中打开 nitro-app 目录。
Prisma 适配器设置
本指南假设您对 Prisma 有基本的了解。如果您是 Prisma 的新手，可以查看 Prisma 文档。
本指南中使用的 sqlite 数据库在生产环境中无法工作。您应该将其替换为生产就绪的数据库，如 PostgreSQL。
在本指南中，我们将使用 Prisma 适配器。您可以通过运行以下命令安装 prisma 客户端：
npm install @prisma/clientprisma 可以作为开发依赖项通过以下命令安装：
npm install -D prisma通过运行以下命令在 prisma 目录中生成 schema.prisma 文件：
npx prisma init您现在可以用以下内容替换 schema.prisma 文件的内容：
generator client {
provider = "prisma-client-js"
}
datasource db {
provider = "sqlite"
url = env("DATABASE_URL")
}
// 将被删除。只需它来生成 prisma 客户端
model Test {
id Int @id @default(autoincrement())
name String
}确保您在 .env 文件中更新 DATABASE_URL 以指向数据库的位置。
DATABASE_URL="file:./dev.db"运行以下命令生成 Prisma 客户端并同步数据库：
npx prisma db push安装和配置 Better Auth
按照 安装指南 中的步骤 1 和 2 在您的 Nitro 应用程序中安装 Better Auth 并设置环境变量。
完成此操作后，在 server/utils/auth.ts 文件中创建您的 Better Auth 实例。
import { betterAuth } from "better-auth";
import { prismaAdapter } from "better-auth/adapters/prisma";
import { PrismaClient } from "@prisma/client";
const prisma = new PrismaClient();
export const auth = betterAuth({
database: prismaAdapter(prisma, { provider: "sqlite" }),
emailAndPassword: { enabled: true },
});更新 Prisma 架构
使用 Better Auth CLI 通过运行以下命令更新您的 Prisma 架构以包含所需的模型：
npx @better-auth/cli generate --config server/utils/auth.ts--config 标志用于指定您创建 Better Auth 实例的文件路径。
前往 prisma/schema.prisma 文件并保存文件以触发保存时格式化。
保存文件后，您可以运行 npx prisma db push 命令来更新数据库架构。
挂载处理程序
您现在可以在 Nitro 应用程序中挂载 Better Auth 处理程序。您可以通过将以下代码添加到 server/routes/api/auth/[...all].ts 文件中来实现：
export default defineEventHandler((event) => {
return auth.handler(toWebRequest(event));
});这是一个 捕获所有 路由，将处理所有针对 /api/auth/* 的请求。
CORS
您可以通过创建插件为 Nitro 应用配置 CORS。
首先安装 cors 包：
npm install cors您现在可以创建一个新文件 server/plugins/cors.ts 并添加以下代码：
import cors from "cors";
export default defineNitroPlugin((plugin) => {
plugin.h3App.use(
fromNodeMiddleware(
cors({
origin: "*",
}),
),
);
});这将为所有路由启用 CORS。您可以自定义 origin 属性以允许来自特定域的请求。确保配置与您的前端应用程序保持同步。
身份验证守卫/中间件
您可以向 Nitro 应用程序添加身份验证守卫来保护需要身份验证的路由。您可以通过创建一个新文件 server/utils/require-auth.ts 并添加以下代码来实现：
import { EventHandler, H3Event } from "h3";
import { fromNodeHeaders } from "better-auth/node";
/**
* 用于要求路由身份验证的中间件。
*
* 可以扩展以检查特定角色或权限。
*/
export const requireAuth: EventHandler = async (event: H3Event) => {
const headers = event.headers;
const session = await auth.api.getSession({
headers: headers,
});
if (!session)
throw createError({
statusCode: 401,
statusMessage: "未授权",
});
// 您可以将会话保存到事件上下文中以供后续使用
event.context.auth = session;
};您现在可以在路由中使用此事件处理程序/中间件来保护它们：
// 路由处理程序的对象语法
export default defineEventHandler({
// 用户必须登录才能访问此路由
onRequest: [requireAuth],
handler: async (event) => {
setResponseStatus(event, 201, "秘密数据");
return { message: "秘密数据" };
},
});示例
您可以在 此处 找到集成 Better Auth 和 Prisma 的 Nitro 应用程序示例。