PDO — Les bases

Guide 01 / 4

Lexique PDO

Donner du sens aux mots de PDO en les reliant au mini-blog de recettes.

Résultat attendu :

Expliquer les notions avec ses propres mots et les reconnaître dans un exemple.

Lecture
0%

01 · Se repérer avant de commencer

Étape 6/6 du fil rouge « À table ! », un mini-blog de recettes. Avancer à son rythme : lire, reproduire, modifier, puis vérifier.

Le parcours et le résultat de cette étape

Relier PHP à la base MySQL du cours précédent : rechercher les recettes, consulter une fiche et enregistrer une nouvelle recette qui reste disponible après rechargement. Le même jeu de données accompagne les six cours : Soupe de carottes (20 min), Salade de tomates (10 min), Tarte aux pommes (45 min).

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

Chaque cours a quatre guides : lexique, essentiels, atelier et ressources. Les fichiers complets sont à la fin de l’atelier.

Prérequis et environnement

Avoir terminé PHP et MySQL. Disposer de la base blog_recettes créée avec le schema.sql du cours MySQL, des trois recettes de référence et de PHP 8.x avec pdo_mysql et mbstring. Garder functions.php du cours PHP et style.css du cours CSS. Le serveur MySQL doit être démarré et joignable depuis PHP. Cet atelier se pratique sur son poste local.

mini-blog/
  index.html       # HTML, CSS et JavaScript
  style.css        # ajouté à l’étape CSS
  app.js           # ajouté à l’étape JavaScript
  public/          # pages PHP accessibles par HTTP
  includes/        # fonctions, connexion et données PHP
  database/        # scripts SQL
À retenir :

Créer ce dossier de travail séparément des fichiers de cours Technipédia. Les chemins des exemples sont relatifs à mini-blog/. Ne pas remplacer la page HTML de cette plateforme.

La méthode : comprendre, reproduire, transformer

Lire une fiche puis taper son exemple. Expliquer ce qui change à l’écran. Modifier une seule chose à la fois et comparer au résultat attendu. Garder une copie de l’étape précédente avant de poursuivre.

1. Je lis et je reformule.
2. Je reproduis dans mon mini-blog.
3. Je change une valeur ou une règle.
4. Je vérifie et j’explique le résultat.
À retenir :

Les extraits courts illustrent une notion ; seuls les fichiers annoncés comme complets sont à copier tels quels. Les fragments ne sont pas à concaténer dans un fichier unique.

02 · Relier PHP au moteur SQL

PDO est une interface PHP d’accès aux données, pas un langage ni une base supplémentaire.

PDO et pilote

PDO propose une interface pour communiquer avec des bases. Le pilote pdo_mysql permet de parler à MySQL. Les requêtes restent écrites dans le dialecte SQL du serveur ciblé.

PHP → PDO → pilote pdo_mysql → serveur MySQL
MySQL → lignes → tableaux PHP → HTML
À retenir :

Changer de pilote ne rend pas automatiquement tout le SQL compatible avec un autre moteur.

DSN

Le DSN décrit le type de connexion, l’hôte, le port, le nom de la base et l’encodage. Le compte et le mot de passe sont transmis séparément au constructeur.

$dsn = "mysql:host=127.0.0.1;port=3306;dbname=blog_recettes;charset=utf8mb4";
À retenir :

localhost peut utiliser un socket selon la configuration ; 127.0.0.1 désigne ici une connexion TCP locale.

Instance PDO et méthode

new PDO crée un objet de connexion. Une méthode est une action de cet objet, appelée avec ->, comme prepare ou query.

$pdo = new PDO($dsn, $utilisateur, $motDePasse, $options);
$requete = $pdo->prepare("SELECT titre FROM recettes WHERE id = :id");

PDOStatement

Un PDOStatement représente une requête préparée ou son résultat. execute lance l’exécution ; fetch et fetchAll lisent ensuite les lignes.

$requete->execute(["id" => 1]);
$recette = $requete->fetch();

Paramètre lié

Un paramètre est un emplacement pour une valeur externe, séparé du texte SQL. :id est un paramètre nommé. Il ne faut pas l’entourer d’apostrophes dans la requête.

$requete = $pdo->prepare("SELECT titre FROM recettes WHERE id = :id");
$requete->execute(["id" => 1]);
À retenir :

Un paramètre représente une valeur entière, pas un nom de colonne ou une clause ORDER BY.

Injection SQL

Une injection survient quand une valeur externe modifie la structure de la requête. Séparer SQL et paramètres empêche cette valeur d’être interprétée comme du code SQL dans les emplacements liés.

// La valeur arrive séparément du SQL.
$requete = $pdo->prepare("SELECT titre FROM recettes WHERE titre = :titre");
$requete->execute(["titre" => $titre]);
À retenir :

Éviter de concaténer $_GET ou $_POST au SQL. La validation reste nécessaire pour les règles métier.

03 · Comprendre l’écriture depuis un formulaire

Le formulaire passe par plusieurs contrôles avant l’enregistrement.

Exception et try/catch

Avec ERRMODE_EXCEPTION, PDO signale un échec par une exception. try entoure l’opération ; catch intercepte le problème pour répondre sans afficher les détails de la connexion.

try {
    $requete->execute();
} catch (PDOException $erreur) {
    http_response_code(500);
    exit("Opération indisponible.");
}

Session et jeton CSRF

Une session relie des requêtes du même navigateur grâce à un cookie. Un jeton aléatoire conservé en session et envoyé dans le formulaire permet de vérifier qu’une écriture provient du formulaire attendu.

session_start();
$_SESSION['csrf'] = bin2hex(random_bytes(32));
À retenir :

La version complète génère le jeton seulement s’il manque et le compare avec hash_equals. Ce jeton ne remplace ni l’authentification ni les autorisations.

POST, redirection et GET

Après un enregistrement réussi en POST, le serveur répond par une redirection 303 vers la fiche en GET. Actualiser cette fiche ne renvoie pas le formulaire.

header('Location: recette.php?id=' . $nouvelId, true, 303);
exit;
À retenir :

Cette organisation évite le renvoi dû à l’actualisation de la page finale ; elle ne garantit pas l’absence de doublons en cas de deux soumissions distinctes.

Identifiant ajouté et persistance

lastInsertId récupère l’identifiant généré sur cette connexion. Après INSERT, les données sont dans MySQL et restent accessibles aux requêtes suivantes.

$nouvelId = (int) $pdo->lastInsertId();
À retenir :

Ne pas supposer que la nouvelle recette aura l’id 4 : AUTO_INCREMENT peut comporter des trous.