Guide 01 / 4
Lexique PDO
Donner du sens aux mots de PDO en les reliant au mini-blog de recettes.
Expliquer les notions avec ses propres mots et les reconnaître dans un exemple.
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).
Exemple
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.
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.
Exemple
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
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.
Exemple
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.
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é.
Exemple
PHP → PDO → pilote pdo_mysql → serveur MySQL
MySQL → lignes → tableaux PHP → HTML
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.
Exemple
$dsn = "mysql:host=127.0.0.1;port=3306;dbname=blog_recettes;charset=utf8mb4";
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.
Exemple
$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.
Exemple
$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.
Exemple
$requete = $pdo->prepare("SELECT titre FROM recettes WHERE id = :id");
$requete->execute(["id" => 1]);
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.
Exemple
// La valeur arrive séparément du SQL.
$requete = $pdo->prepare("SELECT titre FROM recettes WHERE titre = :titre");
$requete->execute(["titre" => $titre]);
É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.
Exemple
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.
Exemple
session_start();
$_SESSION['csrf'] = bin2hex(random_bytes(32));
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.
Exemple
header('Location: recette.php?id=' . $nouvelId, true, 303);
exit;
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.
Exemple
$nouvelId = (int) $pdo->lastInsertId();
Ne pas supposer que la nouvelle recette aura l’id 4 : AUTO_INCREMENT peut comporter des trous.