Développement et production

Cours Débutant Gratuit

PDO — Les bases

Connecter PHP à MySQL avec PDO : requêtes préparées, transactions et gestion des erreurs.

  • 4 guides
  • 42 notions
Commencer la lecture

Les guides

  1. 01 Guide Lexique PDO Expliquer les notions avec ses propres mots et les reconnaître dans un exemple. 13 notions
  2. 02 Guide Les essentiels de PDO Choisir et utiliser les éléments essentiels pour réaliser cette étape du blog. 14 notions
  3. 03 Guide Atelier PDO · À table ! Reproduire une réalisation fonctionnelle, la tester, puis réussir un exercice sans recopier. 9 notions
  4. 04 Guide Ressources et bilan Trouver une information fiable et expliquer ce que l’on a construit. 6 notions

Parcours conseillé

  1. 01. HTML : structurer trois recettes dans une page sémantique.
  2. 02. CSS : rendre le blog lisible sur mobile et sur ordinateur.
  3. 03. JavaScript : filtrer les recettes sans recharger la page.
  4. 04. PHP : produire les pages depuis des tableaux et traiter un formulaire.
  5. 05. MySQL : conserver les recettes dans une base relationnelle.
  6. 06. PDO : lire et ajouter des recettes depuis PHP avec des requêtes préparées.

Sources et références

Atelier débutant, étape 6/6. Les fichiers complets sont des supports à reproduire dans un projet local séparé. Lire les prérequis, les résultats attendus et les limites indiquées dans l’atelier.

Fichiers d’exemple

includes/functions.php
<?php
// Fichier PHP sans balise de fermeture pour éviter les sorties accidentelles.
function h(string $valeur): string
{
    return htmlspecialchars($valeur, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}

function texte(array $donnees, string $cle): string
{
    $valeur = $donnees[$cle] ?? '';
    return is_string($valeur) ? trim($valeur) : '';
}
includes/db.php
<?php
$utilisateur = getenv('DB_USER');
$motDePasse = getenv('DB_PASSWORD');
if ($utilisateur === false || $utilisateur === '' || $motDePasse === false) {
    http_response_code(500);
    exit('Configurer DB_USER et DB_PASSWORD dans le terminal du serveur PHP.');
}
$hote = getenv('DB_HOST') ?: '127.0.0.1';
$port = getenv('DB_PORT') ?: '3306';
$base = getenv('DB_NAME') ?: 'blog_recettes';
$dsn = "mysql:host={$hote};port={$port};dbname={$base};charset=utf8mb4";
try {
    return new PDO($dsn, $utilisateur, $motDePasse, [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES => false,
    ]);
} catch (PDOException $erreur) {
    // Ne pas envoyer le DSN, le mot de passe ou le détail technique au visiteur.
    error_log('Connexion MySQL indisponible, SQLSTATE : ' . $erreur->getCode());
    http_response_code(500);
    exit('La base est indisponible. Vérifier la configuration locale du serveur.');
}
public/index.php
<?php
require __DIR__ . '/../includes/functions.php';
$pdo = require __DIR__ . '/../includes/db.php';
$q = texte($_GET, 'q');
$sql = 'SELECT r.id, r.titre, r.duree_minutes, r.portions, c.nom AS categorie
        FROM recettes AS r JOIN categories AS c ON c.id = r.categorie_id';
$parametres = [];
if ($q !== '') {
    $sql .= ' WHERE r.titre LIKE :recherche';
    $parametres['recherche'] = '%' . $q . '%';
}
$sql .= ' ORDER BY r.id';
try {
    $requete = $pdo->prepare($sql);
    $requete->execute($parametres);
    $recettes = $requete->fetchAll();
} catch (PDOException $erreur) {
    error_log('Lecture des recettes impossible, SQLSTATE : ' . $erreur->getCode());
    http_response_code(500);
    exit('Impossible de charger les recettes pour le moment.');
}
?>
<!doctype html>
<html lang="fr">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>À table ! · Recettes en base</title>
  <link rel="stylesheet" href="style.css">
</head>
<body>
  <header class="entete"><h1>À table !</h1><a href="ajouter.php">Ajouter une recette</a></header>
  <main class="conteneur">
    <h2>Nos recettes maison</h2>
    <form method="get" action="index.php">
      <label for="q">Rechercher par titre</label>
      <input id="q" name="q" type="search" value="<?= h($q) ?>">
      <button type="submit">Rechercher</button>
      <a href="index.php">Tout afficher</a>
    </form>
    <p><?= count($recettes) ?> recette(s) trouvée(s).</p>
    <?php if ($recettes === []): ?><p>Aucune recette trouvée.</p><?php endif; ?>
    <div class="recettes">
      <?php foreach ($recettes as $recette): ?>
        <article class="recette">
          <h3><a href="recette.php?id=<?= (int) $recette['id'] ?>"><?= h($recette['titre']) ?></a></h3>
          <p class="meta"><?= (int) $recette['duree_minutes'] ?> min · <?= (int) $recette['portions'] ?> personnes · <?= h($recette['categorie']) ?></p>
        </article>
      <?php endforeach; ?>
    </div>
  </main>
</body>
</html>
public/recette.php
<?php
require __DIR__ . '/../includes/functions.php';
$id = filter_var($_GET['id'] ?? null, FILTER_VALIDATE_INT, [
    'options' => ['min_range' => 1],
]);
if ($id === false) {
    http_response_code(400);
    exit('Identifiant de recette invalide.');
}
$pdo = require __DIR__ . '/../includes/db.php';
try {
    $requete = $pdo->prepare(
        'SELECT r.id, r.titre, r.duree_minutes, r.portions,
                r.ingredients, r.etapes, c.nom AS categorie
         FROM recettes AS r JOIN categories AS c ON c.id = r.categorie_id
         WHERE r.id = :id'
    );
    $requete->bindValue(':id', $id, PDO::PARAM_INT);
    $requete->execute();
    $recette = $requete->fetch();
} catch (PDOException $erreur) {
    error_log('Lecture de la fiche impossible, SQLSTATE : ' . $erreur->getCode());
    http_response_code(500);
    exit('Impossible de charger cette recette pour le moment.');
}
if ($recette === false) {
    http_response_code(404);
    exit('Recette introuvable.');
}
?>
<!doctype html>
<html lang="fr">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title><?= h($recette['titre']) ?> · À table !</title>
  <link rel="stylesheet" href="style.css">
</head>
<body>
  <main class="conteneur">
    <a href="index.php">Toutes les recettes</a>
    <article class="recette">
      <h1><?= h($recette['titre']) ?></h1>
      <p><?= (int) $recette['duree_minutes'] ?> min · <?= (int) $recette['portions'] ?> personnes · <?= h($recette['categorie']) ?></p>
      <h2>Ingrédients</h2>
      <ul><?php foreach (explode("\n", $recette['ingredients']) as $ligne): ?>
        <li><?= h($ligne) ?></li>
      <?php endforeach; ?></ul>
      <h2>Préparation</h2>
      <ol><?php foreach (explode("\n", $recette['etapes']) as $ligne): ?>
        <li><?= h($ligne) ?></li>
      <?php endforeach; ?></ol>
    </article>
  </main>
</body>
</html>
public/ajouter.php
<?php
// La session doit démarrer avant toute sortie HTML.
session_set_cookie_params(['httponly' => true, 'samesite' => 'Lax']);
session_start();
require __DIR__ . '/../includes/functions.php';
$pdo = require __DIR__ . '/../includes/db.php';
if (!isset($_SESSION['csrf'])) {
    $_SESSION['csrf'] = bin2hex(random_bytes(32));
}
$erreurs = [];
$titre = $dureeSaisie = $portionsSaisies = $categorieSaisie = '';
$ingredients = $etapes = '';
try {
    $categories = $pdo->query('SELECT id, nom FROM categories ORDER BY nom')->fetchAll();

    if ($_SERVER['REQUEST_METHOD'] === 'POST') {
        $jeton = texte($_POST, 'csrf');
        if (!hash_equals($_SESSION['csrf'], $jeton)) {
            http_response_code(403);
            exit('Formulaire expiré ou invalide. Recharger la page avant de réessayer.');
        }
        $titre = texte($_POST, 'titre');
        $dureeSaisie = texte($_POST, 'duree_minutes');
        $portionsSaisies = texte($_POST, 'portions');
        $categorieSaisie = texte($_POST, 'categorie_id');
        // Uniformiser les sauts de ligne Windows et Linux.
        $ingredients = str_replace(["\r\n", "\r"], "\n", texte($_POST, 'ingredients'));
        $etapes = str_replace(["\r\n", "\r"], "\n", texte($_POST, 'etapes'));
        $duree = filter_var($dureeSaisie, FILTER_VALIDATE_INT, [
            'options' => ['min_range' => 1, 'max_range' => 1440],
        ]);
        $portions = filter_var($portionsSaisies, FILTER_VALIDATE_INT, [
            'options' => ['min_range' => 1, 'max_range' => 20],
        ]);
        $categorieId = filter_var($categorieSaisie, FILTER_VALIDATE_INT, [
            'options' => ['min_range' => 1],
        ]);
        if (mb_strlen($titre, 'UTF-8') < 3 || mb_strlen($titre, 'UTF-8') > 120) {
            $erreurs[] = 'Le titre doit contenir entre 3 et 120 caractères.';
        }
        if ($duree === false) { $erreurs[] = 'La durée doit être un entier entre 1 et 1440.'; }
        if ($portions === false) { $erreurs[] = 'Les portions doivent être un entier entre 1 et 20.'; }
        if ($ingredients === '' || mb_strlen($ingredients, 'UTF-8') > 5000) {
            $erreurs[] = 'Renseigner les ingrédients, au maximum 5000 caractères.';
        }
        if ($etapes === '' || mb_strlen($etapes, 'UTF-8') > 10000) {
            $erreurs[] = 'Renseigner les étapes, au maximum 10000 caractères.';
        }
        $categorieExiste = false;
        if ($categorieId !== false) {
            foreach ($categories as $categorie) {
                if ((int) $categorie['id'] === $categorieId) {
                    $categorieExiste = true;
                    break;
                }
            }
        }
        if (!$categorieExiste) { $erreurs[] = 'Choisir une catégorie existante.'; }

        if ($erreurs === []) {
            $requete = $pdo->prepare(
                'INSERT INTO recettes (titre, duree_minutes, portions, ingredients, etapes, categorie_id)
                 VALUES (:titre, :duree, :portions, :ingredients, :etapes, :categorie)'
            );
            $requete->bindValue(':titre', $titre, PDO::PARAM_STR);
            $requete->bindValue(':duree', $duree, PDO::PARAM_INT);
            $requete->bindValue(':portions', $portions, PDO::PARAM_INT);
            $requete->bindValue(':ingredients', $ingredients, PDO::PARAM_STR);
            $requete->bindValue(':etapes', $etapes, PDO::PARAM_STR);
            $requete->bindValue(':categorie', $categorieId, PDO::PARAM_INT);
            $requete->execute();
            $nouvelId = (int) $pdo->lastInsertId();
            // Redirection vers une lecture : actualiser la fiche ne répète pas le POST.
            header('Location: recette.php?id=' . $nouvelId, true, 303);
            exit;
        }
    }
} catch (PDOException $erreur) {
    error_log('Opération sur les recettes impossible, SQLSTATE : ' . $erreur->getCode());
    http_response_code(500);
    exit('Impossible de terminer cette opération pour le moment.');
}
?>
<!doctype html>
<html lang="fr">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Ajouter une recette · À table !</title>
  <link rel="stylesheet" href="style.css">
</head>
<body>
  <main class="conteneur">
    <a href="index.php">Toutes les recettes</a>
    <h1>Ajouter une recette</h1>
    <?php if ($erreurs !== []): ?>
      <div role="alert"><ul><?php foreach ($erreurs as $erreur): ?>
        <li><?= h($erreur) ?></li>
      <?php endforeach; ?></ul></div>
    <?php endif; ?>
    <form method="post" action="ajouter.php">
      <input type="hidden" name="csrf" value="<?= h($_SESSION['csrf']) ?>">
      <p><label for="titre">Titre</label><br>
        <input id="titre" name="titre" required minlength="3" maxlength="120" value="<?= h($titre) ?>"></p>
      <p><label for="duree_minutes">Durée en minutes</label><br>
        <input id="duree_minutes" name="duree_minutes" type="number" required min="1" max="1440" value="<?= h($dureeSaisie) ?>"></p>
      <p><label for="portions">Nombre de personnes</label><br>
        <input id="portions" name="portions" type="number" required min="1" max="20" value="<?= h($portionsSaisies) ?>"></p>
      <p><label for="categorie_id">Catégorie</label><br>
        <select id="categorie_id" name="categorie_id" required>
          <option value="">Choisir une catégorie</option>
          <?php foreach ($categories as $categorie): ?>
            <option value="<?= (int) $categorie['id'] ?>" <?= $categorieSaisie === (string) $categorie['id'] ? 'selected' : '' ?>><?= h($categorie['nom']) ?></option>
          <?php endforeach; ?>
        </select></p>
      <p><label for="ingredients">Ingrédients (un par ligne)</label><br>
        <textarea id="ingredients" name="ingredients" required maxlength="5000" rows="6"><?= h($ingredients) ?></textarea></p>
      <p><label for="etapes">Préparation (une étape par ligne)</label><br>
        <textarea id="etapes" name="etapes" required maxlength="10000" rows="6"><?= h($etapes) ?></textarea></p>
      <button type="submit">Enregistrer la recette</button>
    </form>
  </main>
</body>
</html>

Dans la même série Étape 6 sur 6

  1. 1 Cours HTML — Les bases
  2. 2 Cours CSS — Les bases
  3. 3 Cours JavaScript — Les bases
  4. 4 Cours PHP — Les bases
  5. 5 Cours MySQL — Les bases
  6. 6 Cours PDO — Les bases Vous êtes ici

Partager cet article

Dans la même catégorie

Cours

Développement et production · Débutant

HTML — Les bases

Structurer une page web sémantique et accessible, pas à pas, avec le fil rouge « À table ! » : un mini-blog de recettes.

4 guides · 38 notions Dans la même série

Cours

Développement et production · Intermédiaire

Node.js — Les fondamentaux

Comprendre le moteur d'exécution Node.js : modules, asynchronisme, npm et création d'un petit serveur.

4 guides · 44 notions Dans la même série

Cours

Développement et production · Débutant

CSS — Les bases

Mettre en forme et rendre responsive le mini-blog de recettes : sélecteurs, boîtes, flexbox, grille et mobile d'abord.

4 guides · 39 notions Dans la même série