Prisma pour la gestion des données (et un peu de magie)

Introduction à Prisma pour simplifier la gestion des données ✨

Prisma, c’est l'outil magique pour gérer les bases de données avec Node.js sans te faire tirer les cheveux ! 🧙‍♂️ Oublie les ORM d’un autre temps où chaque requête te donnait des maux de tête. Prisma, c’est rapide, simple et adapté aux développeurs modernes. Dans cet article, on va découvrir pourquoi Prisma va devenir ton meilleur ami (si ce n’est déjà fait 😉), et comment le coupler avec Zod pour une validation de données aux petits oignons.

Pourquoi Prisma ? 🤔

En quelques mots : Prisma est fait pour te faciliter la vie. Voici ce qui rend Prisma spécial :

• Typage automatique 🎉 : Des types TypeScript générés automatiquement pour un code solide comme un roc.
• Performances optimisées 🚀 : Prisma s’assure que tes requêtes sont efficaces. Terminé les bases de données fatiguées !
• Simplicité 😎 : Une syntaxe claire et concise qui te donne envie d'écrire des requêtes !

Installation de Prisma avec pnpm 🛠️

Prêt pour l’aventure Prisma ? Allons-y ! Pour l'installer, démarre par ces quelques lignes de commande :

bash

Cela va générer un dossier prisma avec un fichier schema.prisma et un fichier .env pour la configuration de la base de données.

Configuration de Prisma pour PostgreSQL 🐘

Avant de pouvoir utiliser Prisma avec PostgreSQL, il te faut une base de données PostgreSQL accessible. Une fois ta base de données PostgreSQL prête, ajoute son URL de connexion dans le fichier .env créé par Prisma. Par exemple :

dotenv

Remplace USER, PASSWORD, localhost, 5432 et ma_base_de_donnees par tes informations de connexion PostgreSQL. Prisma utilisera cette URL pour se connecter à ta base de données.

Ensuite, dans le fichier schema.prisma, assure-toi que le fournisseur (provider) de la base de données est bien configuré sur PostgreSQL :

prisma

Et voilà ! Prisma est maintenant configuré pour se connecter à PostgreSQL. 🎉

Définir des modèles avec Prisma : l'exemple du blog 📝

Imaginons que tu crées un blog (classique, mais efficace) avec des utilisateurs (User) et des publications (Post). Voici à quoi ressemble un schéma Prisma dans schema.prisma :

prisma

Simple, non ? Prisma te permet de déclarer des modèles comme User et Post qui gèrent les relations et tout ce qu’il faut pour que tout roule sans accroc. 👌

Migration de la base de données : la magie continue ✨

Une fois ton schéma en place, il est temps de le transformer en tables dans ta base de données. C’est ce qu’on appelle une migration. Pour lancer ta première migration, exécute cette commande :

bash

Et voilà, ta base de données est configurée ! Prisma a fait tout le boulot en arrière-plan, comme un vrai assistant de données. 🧙‍♀️

Prisma Client : Le génie qui exécute tes requêtes 💡

Prisma Client est un ORM puissant qui te permet de manipuler tes données facilement. Voici quelques exemples pour illustrer :

Créer un utilisateur

typescript

Lire des données

Tu veux voir toutes les publications ? Voici comment faire :

typescript

Mettre à jour une publication

Une publication en mode brouillon ? Pas de souci, on la publie en un clin d'œil :

typescript

Supprimer un utilisateur 😢

Une action triste, mais parfois nécessaire. Voici comment supprimer un utilisateur et toutes ses publications associées :

typescript

Partie avancée : Validation des données avec Zod 🛡️

Prisma gère la structure de tes données, mais qu'en est-il de la validation ? C'est là que Zod entre en scène ! Imagine une couche de sécurité supplémentaire qui s’assure que les données sont correctes avant même de les enregistrer en base. C'est ce que fait Zod, avec style et efficacité ! 🎩

Intégration de Zod : ajouter une validation sans faille ⚔️

Pour utiliser Zod avec Prisma, installe-le dans ton projet.

bash

Définir des schémas Zod pour la validation

Prenons un exemple de validation pour la création d’un utilisateur. Nous allons définir un schéma Zod afin de s'assurer que les données sont correctes avant de les transmettre à Prisma.

typescript

Validation des données avant insertion

Avant de créer un utilisateur avec Prisma, on valide les données avec Zod. Si elles sont conformes, elles sont envoyées à Prisma. Sinon, une erreur de validation est renvoyée (et pas question de la contourner !).

typescript

Validation avancée avec des relations (et plus de fun 🤹‍♂️)

Zod fonctionne également pour les données complexes. Par exemple, pour créer une Post, on vérifie que l’authorId existe et est valide :

typescript

Conclusion 🏁

Avec Prisma, gérer des bases de données devient un jeu d’enfant (et un vrai plaisir !) 🎉. En ajoutant Zod, tu ajoutes une couche de validation puissante qui rend ton code encore plus robuste et sécurisé. Que tu développes une application complexe ou un projet perso, cette combinaison te donne une gestion des données fiable, rapide et sans soucis. Alors, prêt à ajouter Prisma et Zod à ta boîte à outils ? 🛠️

1# .env
2DATABASE_URL="postgresql://USER:PASSWORD@localhost:5432/ma_base_de_donnees?schema=public"

1# Initialise un projet Node.js si ce n’est pas déjà fait
2pnpm init -y
3
4# Installe Prisma CLI
5pnpm add prisma --save-dev
6
7# Initialise Prisma dans ton projet
8pnpm prisma init

1# Crée et applique une migration
2pnpm prisma migrate dev --name init

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',
8      email: 'alice@example.com',
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); // Publie le post avec l'ID 1

1async function deleteUser(userId: number) {
2  await prisma.user.delete({
3    where: { id: userId },
4  });
5  console.log(`User with ID ${userId} has been deleted`);
6}
7
8deleteUser(1); // Supprime l'utilisateur avec l'ID 1

1pnpm add zod

1import { z } from 'zod';
2
3// Schéma de validation pour User
4const userSchema = z.object({
5  name: z.string().min(1, 'Le nom est requis'),
6  email: z.string().email('Email invalide'),
7});

1import { PrismaClient } from '@prisma/client';
2import { z } from 'zod';
3
4const prisma = new PrismaClient();
5
6async function createUser(data: unknown) {
7  // Validation des données avec Zod
8  const parsedData = userSchema.safeParse(data);
9  if (!parsedData.success) {
10    console.error(parsedData.error);
11    return;
12  }
13
14  // Si validation réussie, création de l'utilisateur
15  const user = await prisma.user.create({
16    data: parsedData.data,
17  });
18  console.log(user);
19}
20
21// Exemple d'appel de la fonction
22createUser({ name: 'Bob', email: 'bob@example.com' });

1// Schéma de validation pour Post
2const postSchema = z.object({
3  title: z.string().min(1, 'Le titre est requis'),
4  content: z.string().optional(),
5  authorId: z.number().int().positive('authorId doit être un entier positif'),
6});
7
8async function createPost(data: unknown) {
9  // Validation des données
10  const parsedData = postSchema.safeParse(data);
11  if (!parsedData.success) {
12    console.error(parsedData.error);
13    return;
14  }
15
16  // Si validation réussie, création de la publication
17  const post = await prisma.post.create({
18    data: parsedData.data,
19  });
20  console.log(post);
21}
22
23// Exemple d'appel de la fonction
24createPost({ title: 'Introduction à Prisma', authorId: 1 });

1// schema.prisma
2generator client {
3  provider = "prisma-client-js"
4}
5
6datasource db {
7  provider = "postgresql"
8  url      = env("DATABASE_URL")
9}

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}