Prisma 简介：简化数据管理 ✨
Prisma 是使用 Node.js 管理数据库的神奇工具，让你不再为数据库操作而烦恼！🧙♂️ 忘掉那些让你头疼的老式 ORM 吧。Prisma 快速、简单，完全适应现代开发者的需求。在本文中，我们将探讨为什么 Prisma 会成为你最好的朋友（如果还不是的话 😉），以及如何将其与 Zod 结合使用，实现完美的数据验证。
为什么选择 Prisma？🤔
简而言之：Prisma 就是为了让你的工作更轻松。以下是 Prisma 的特别之处：
- 自动类型生成 🎉：自动生成 TypeScript 类型，让代码坚如磐石。
- 性能优化 🚀：Prisma 确保你的查询高效执行。告别疲惫的数据库！
- 简单易用 😎：清晰简洁的语法，让你享受编写查询的过程！
使用 pnpm 安装 Prisma 🛠️
准备好开始 Prisma 之旅了吗？让我们开始吧！首先执行以下命令：
1# 如果还没有初始化 Node.js 项目，先初始化
2pnpm init -y
3
4# 安装 Prisma CLI
5pnpm add prisma --save-dev
6
7# 在项目中初始化 Prisma
8pnpm prisma init
这将生成一个包含 schema.prisma 文件的 prisma 文件夹和用于数据库配置的 .env 文件。
为 PostgreSQL 配置 Prisma 🐘
在使用 Prisma 连接 PostgreSQL 之前，你需要一个可访问的 PostgreSQL 数据库。准备好数据库后，将连接 URL 添加到 Prisma 创建的 .env 文件中。例如：
1# .env
2DATABASE_URL="postgresql://USER:PASSWORD@localhost:5432/my_database?schema=public"
将 USER、PASSWORD、localhost、5432 和 my_database 替换为你的 PostgreSQL 连接信息。Prisma 将使用此 URL 连接到你的数据库。
然后，在 schema.prisma 文件中，确保数据库提供者（provider）配置为 PostgreSQL：
1// schema.prisma
2generator client {
3 provider = "prisma-client-js"
4}
5
6datasource db {
7 provider = "postgresql"
8 url = env("DATABASE_URL")
9}
好了！Prisma 现已配置完成，可以连接 PostgreSQL 了。🎉
使用 Prisma 定义模型：博客示例 📝
假设你要创建一个博客（经典但实用）包含用户（User）和文章（Post）。以下是 schema.prisma 中的 Prisma 模型定义：
1// schema.prisma
2model User {
3 id Int @id @default(autoincrement())
4 name String
5 email String @unique
6 posts Post[]
7}
8
9model Post {
10 id Int @id @default(autoincrement())
11 title String
12 content String?
13 published Boolean @default(false)
14 author User @relation(fields: [authorId], references: [id])
15 authorId Int
16}
很简单，对吧？Prisma 让你可以声明如 User 和 Post 这样的模型，它们会自动处理关系和所有必要的细节。👌
数据库迁移：魔法继续 ✨
模型定义好后，是时候将其转换为数据库表了。这就是所谓的迁移。要执行你的第一次迁移，运行以下命令：
1# 创建并应用迁移
2pnpm prisma migrate dev --name init
瞧，你的数据库已经配置完成！Prisma 在后台完成了所有工作，就像一个真正的数据助手。🧙♀️
Prisma Client：执行查询的精灵 💡
Prisma Client 是一个强大的 ORM，让你可以轻松操作数据。以下是一些示例：
创建用户
1import { PrismaClient } from '@prisma/client';
2const prisma = new PrismaClient();
3
4async function createUser() {
5 const user = await prisma.user.create({
6 data: {
7 name: 'Alice',
9 },
10 });
11 console.log(user);
12}
13
14createUser();
读取数据
想要查看所有文章？这样做：
1async function getAllPosts() {
2 const posts = await prisma.post.findMany();
3 console.log(posts);
4}
5
6getAllPosts();
更新文章
有一篇草稿文章？没问题，一眨眼就能发布：
1async function publishPost(postId: number) {
2 const post = await prisma.post.update({
3 where: { id: postId },
4 data: { published: true },
5 });
6 console.log(post);
7}
8
9publishPost(1); // 发布 ID 为 1 的文章
删除用户 😢
虽然有点伤感，但有时候是必要的。以下是如何删除用户及其所有相关文章：
1async function deleteUser(userId: number) {
2 await prisma.user.delete({
3 where: { id: userId },
4 });
5 console.log(`ID 为 ${userId} 的用户已被删除`);
6}
7
8deleteUser(1); // 删除 ID 为 1 的用户
高级部分：使用 Zod 进行数据验证 🛡️
Prisma 处理数据结构，但数据验证呢？这就是 Zod 登场的时候了！想象一个额外的安全层，确保数据在存入数据库之前就是正确的。这就是 Zod 的作用，而且它做得很优雅！🎩
集成 Zod：添加完美的验证 ⚔️
要在 Prisma 中使用 Zod，先安装它：
定义 Zod 验证模式
让我们以用户创建为例，定义一个 Zod 模式来确保数据在传递给 Prisma 之前是正确的。
1import { z } from 'zod';
2
3// User 验证模式
4const userSchema = z.object({
5 name: z.string().min(1, '名字是必需的'),
6 email: z.string().email('无效的邮箱地址'),
7});
插入前的数据验证
在使用 Prisma 创建用户之前，我们用 Zod 验证数据。如果数据符合要求，就发送给 Prisma；如果不符合，就返回验证错误（这是不能绕过的！）。
1import { PrismaClient } from '@prisma/client';
2import { z } from 'zod';
3
4const prisma = new PrismaClient();
5
6async function createUser(data: unknown) {
7 // 使用 Zod 验证数据
8 const parsedData = userSchema.safeParse(data);
9 if (!parsedData.success) {
10 console.error(parsedData.error);
11 return;
12 }
13
14 // 验证成功后创建用户
15 const user = await prisma.user.create({
16 data: parsedData.data,
17 });
18 console.log(user);
19}
20
21// 函数调用示例
关联数据的高级验证（更多乐趣 🤹♂️）
Zod 也适用于复杂数据。例如，创建 Post 时，我们要验证 authorId 存在且有效：
1// Post 验证模式
2const postSchema = z.object({
3 title: z.string().min(1, '标题是必需的'),
4 content: z.string().optional(),
5 authorId: z.number().int().positive('authorId 必须是正整数'),
6});
7
8async function createPost(data: unknown) {
9 // 验证数据
10 const parsedData = postSchema.safeParse(data);
11 if (!parsedData.success) {
12 console.error(parsedData.error);
13 return;
14 }
15
16 // 验证成功后创建文章
17 const post = await prisma.post.create({
18 data: parsedData.data,
19 });
20 console.log(post);
21}
22
23// 函数调用示例
24createPost({ title: 'Prisma 入门', authorId: 1 });
结论 🏁
使用 Prisma，数据库管理变得轻而易举（而且很有趣！）🎉。加入 Zod 后，你就拥有了一个强大的验证层，使你的代码更加健壮和安全。无论你在开发复杂的应用还是个人项目，这个组合都能为你提供可靠、快速、无忧的数据管理。那么，准备好把 Prisma 和 Zod 添加到你的工具箱了吗？🛠️
