Prisma ORM¶

Qu'est-ce qu'un ORM¶

Un ORM (Object-Relational Mapping) est un outil qui permet de manipuler une base de données relationnelle en utilisant des objets dans votre code, plutôt que d'écrire des requêtes SQL manuellement.

Prisma est l'ORM recommandé pour les projets Next.js. Il supporte MySQL, PostgreSQL, SQLite et d'autres bases de données.

Installation et configuration¶

Installer Prisma¶

npm install prisma --save-dev
npm install @prisma/client

Initialiser Prisma avec MySQL¶

npx prisma init --datasource-provider mysql

Cette commande crée :

• Un dossier prisma/ avec un fichier schema.prisma
• Un fichier .env avec la variable DATABASE_URL

Configurer la connexion à la base de données¶

Modifiez le fichier .env avec vos informations de connexion MySQL :

DATABASE_URL="mysql://utilisateur:motdepasse@localhost:3306/nom_de_la_bd"

Schéma Prisma¶

Le fichier schema.prisma est le coeur de Prisma. Il définit la structure de votre base de données.

generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "mysql"
  url      = env("DATABASE_URL")
}

model Produit {
  id          Int       @id @default(autoincrement())
  nom         String
  description String?
  prix        Float
  categorieId Int
  categorie   Categorie @relation(fields: [categorieId], references: [id])
  creeLe      DateTime  @default(now())
  modifieLe   DateTime  @updatedAt
}

model Categorie {
  id       Int       @id @default(autoincrement())
  nom      String    @unique
  produits Produit[]
}

Types de données courants¶

Attributs courants¶

Relations¶

Dans l'exemple ci-dessus, un Produit appartient à une Categorie, et une Categorie peut avoir plusieurs Produit. C'est une relation un-à-plusieurs.

• @relation(fields: [categorieId], references: [id]) : indique que categorieId est la clé étrangère qui pointe vers id de Categorie.
• produits Produit[] : côté inverse de la relation, une catégorie contient un tableau de produits.

Migrations¶

Les migrations permettent de synchroniser votre schéma Prisma avec la base de données.

Créer et appliquer une migration¶

npx prisma migrate dev --name init

Cette commande :

1. Compare le schéma Prisma avec l'état actuel de la base de données
2. Génère un fichier SQL de migration
3. Exécute la migration sur la base de données
4. Régénère le Prisma Client

Réinitialiser la base de données¶

Pour repartir à zéro (supprime toutes les données) :

npx prisma migrate reset

Prisma Client¶

Le Prisma Client est l'objet qui permet d'effectuer des opérations sur la base de données.

Configuration du client¶

Dans un projet Next.js, il est important de créer une instance unique de Prisma Client pour éviter les problèmes de connexion en développement :

import { PrismaClient } from "@prisma/client";

const globalForPrisma = globalThis as unknown as {
  prisma: PrismaClient | undefined;
};

export const prisma = globalForPrisma.prisma ?? new PrismaClient();

if (process.env.NODE_ENV !== "production") {
  globalForPrisma.prisma = prisma;
}

Opérations CRUD¶

Créer (Create)¶

const produit = await prisma.produit.create({
  data: {
    nom: "Clavier mécanique",
    description: "Clavier RGB",
    prix: 129.99,
    categorieId: 1,
  },
});

Lire (Read)¶

// Tous les produits
const produits = await prisma.produit.findMany();

// Un produit par son ID
const produit = await prisma.produit.findUnique({
  where: { id: 1 },
});

// Produits avec leur catégorie (jointure)
const produitsAvecCategorie = await prisma.produit.findMany({
  include: { categorie: true },
});

// Produits filtrés
const produitsElectroniques = await prisma.produit.findMany({
  where: { categorie: { nom: "Électronique" } },
});

Modifier (Update)¶

const produit = await prisma.produit.update({
  where: { id: 1 },
  data: { prix: 99.99 },
});

Supprimer (Delete)¶

await prisma.produit.delete({
  where: { id: 1 },
});

Prisma Studio¶

Prisma Studio est une interface graphique pour visualiser et modifier les données de votre base de données :

npx prisma studio

Cela ouvre un navigateur web à l'adresse http://localhost:5555 avec une interface permettant de consulter, ajouter, modifier et supprimer des enregistrements.

Seed de données¶

Le seeding permet d'insérer des données initiales dans la base de données, utile pour le développement et les tests.

Créer le fichier de seed¶

import { PrismaClient } from "@prisma/client";

const prisma = new PrismaClient();

async function main() {
  // Créer les catégories
  const electronique = await prisma.categorie.create({
    data: { nom: "Électronique" },
  });

  const accessoires = await prisma.categorie.create({
    data: { nom: "Accessoires" },
  });

  // Créer les produits
  await prisma.produit.createMany({
    data: [
      {
        nom: "Clavier mécanique",
        description: "Clavier mécanique RGB",
        prix: 129.99,
        categorieId: electronique.id,
      },
      {
        nom: "Souris ergonomique",
        description: "Souris sans fil ergonomique",
        prix: 79.99,
        categorieId: accessoires.id,
      },
      {
        nom: "Écran 27 pouces",
        description: "Écran 4K IPS",
        prix: 449.99,
        categorieId: electronique.id,
      },
    ],
  });

  console.log("Données de seed insérées avec succès!");
}

main()
  .catch((e) => {
    console.error(e);
    process.exit(1);
  })
  .finally(async () => {
    await prisma.$disconnect();
  });

Configurer le script de seed¶

Ajoutez la configuration suivante dans votre package.json :

{
  "prisma": {
    "seed": "npx tsx prisma/seed.ts"
  }
}

Exécuter le seed¶

npx prisma db seed

Le seed est aussi exécuté automatiquement lors d'un npx prisma migrate reset.