Guide 02 / 4
Les essentiels de PDO
Un aide-mémoire expliqué : à quoi sert chaque élément, comment l’écrire et quand l’utiliser.
Choisir et utiliser les éléments essentiels pour réaliser cette étape du blog.
01 · Configurer une connexion compréhensible
La configuration appartient au serveur, jamais au code JavaScript envoyé au navigateur.
Vérifier les extensions
Le binaire PHP qui lance le serveur doit connaître pdo_mysql et mbstring. php -m affiche les extensions disponibles.
Exemple
php -v
php -m
could not find driver indique généralement que le pilote PDO correspondant n’est pas activé.
Compte MySQL de l’application
Avec un compte administrateur local, créer un compte limité à la base du blog. Remplacer le mot de passe d’exemple et retenir le même compte pour les variables d’environnement.
Exemple
CREATE USER 'blog_app'@'127.0.0.1' IDENTIFIED BY 'REMPLACER_PAR_UN_MOT_DE_PASSE_LOCAL';
GRANT SELECT, INSERT, UPDATE, DELETE ON blog_recettes.* TO 'blog_app'@'127.0.0.1';
À exécuter une seule fois dans MySQL, pas dans PHP. Le compte n’a pas besoin de créer ou supprimer des tables ; adapter l’hôte à l’installation locale si nécessaire.
Variables d’environnement et serveur local
Dans le terminal Bash qui lancera PHP, définir le compte et saisir le mot de passe sans le placer dans une commande enregistrée. Les autres systèmes utilisent leur mécanisme équivalent pour fournir les mêmes variables.
Exemple
export DB_HOST=127.0.0.1
export DB_PORT=3306
export DB_NAME=blog_recettes
export DB_USER=blog_app
read -r -s -p 'Mot de passe MySQL : ' DB_PASSWORD
export DB_PASSWORD
php -S 127.0.0.1:8000 -t public
Ces lignes se tapent depuis mini-blog/. Ne pas ajouter de guillemets SQL au mot de passe saisi. Aucun fichier .env n’est chargé automatiquement par ces exemples.
Options du constructeur PDO
Le mode exception facilite le traitement des erreurs. FETCH_ASSOC fournit des tableaux nommés. Désactiver l’émulation demande des préparations natives au pilote MySQL.
Exemple
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
PDO::ATTR_EMULATE_PREPARES => false,
];
Le fichier includes/db.php complet retourne la connexion configurée ; les pages la chargent avec require.
02 · Préparer, exécuter et lire
Écrire d’abord le SQL attendu, puis ajouter les valeurs externes comme paramètres.
query pour une requête fixe
query exécute directement une requête dont le texte est entièrement fixe. Les catégories ne dépendent pas d’une saisie utilisateur.
Exemple
$categories = $pdo->query('SELECT id, nom FROM categories ORDER BY nom')->fetchAll();
Dès qu’une valeur externe intervient, utiliser prepare et les paramètres.
prepare et execute
prepare décrit la structure de la requête ; execute fournit ses valeurs et l’exécute. Les clés du tableau correspondent aux noms des paramètres.
Exemple
$requete = $pdo->prepare('SELECT titre FROM recettes WHERE id = :id');
$requete->execute(['id' => 1]);
$recette = $requete->fetch();
bindValue avec type explicite
bindValue fixe une valeur avant execute. PARAM_INT précise qu’il s’agit d’un entier, utile pour les identifiants et les limites.
Exemple
$requete = $pdo->prepare('SELECT titre FROM recettes WHERE id = :id');
$requete->bindValue(':id', 1, PDO::PARAM_INT);
$requete->execute();
Choisir soit execute avec tableau, soit bindValue puis execute sans tableau pour une requête donnée.
fetch, fetchAll et absence de résultat
fetch renvoie une ligne ou false. fetchAll renvoie un tableau de lignes, vide s’il n’y en a pas. Une absence n’est pas nécessairement une erreur SQL.
Exemple
$recette = $requete->fetch();
if ($recette === false) {
http_response_code(404);
exit("Recette introuvable.");
}
Pour le petit blog, fetchAll est lisible. Une grande collection demanderait une pagination plutôt que tout charger.
LIKE et motif lié
Le paramètre contient le motif complet. On ajoute % à la valeur transmise, sans le mettre autour du nom du paramètre dans le SQL.
Exemple
$requete = $pdo->prepare('SELECT titre FROM recettes WHERE titre LIKE :recherche');
$requete->execute(['recherche' => '%' . $q . '%']);
Dans cet atelier, % et _ saisis gardent leur sens de caractères génériques SQL. C’est une recherche par motif, pas toujours une recherche littérale.
Compter les résultats de lecture
Pour le petit résultat déjà chargé, utiliser count. Pour compter en base, demander SELECT COUNT(*) puis fetchColumn.
Exemple
$requete = $pdo->query('SELECT COUNT(*) FROM recettes');
$total = (int) $requete->fetchColumn();
Ne pas utiliser rowCount pour compter les lignes d’un SELECT : ce comportement n’est pas portable.
03 · Écrire et protéger les frontières
La base stocke du texte brut ; le HTML est échappé au moment de l’affichage.
INSERT et lastInsertId
Énumérer les colonnes et lier chaque valeur. Le fichier complet d’ajout vérifie d’abord tous les champs et la catégorie.
Exemple
$requete = $pdo->prepare(
'INSERT INTO categories (nom) VALUES (:nom)'
);
$requete->execute(['nom' => 'Goûter']);
$id = (int) $pdo->lastInsertId();
Extrait isolé à essayer une seule fois : nom est UNIQUE. L’atelier complet ajoute une recette, pas une catégorie.
UPDATE et DELETE par identifiant
Pour une modification ou suppression, l’identifiant vérifié limite la ligne concernée. L’extrait ci-dessous est un essai côté serveur, pas une action déclenchée par un lien.
Exemple
$pdo->beginTransaction();
$requete = $pdo->prepare('UPDATE recettes SET duree_minutes = :duree WHERE id = :id');
$requete->execute(['duree' => 25, 'id' => 1]);
$pdo->rollBack();
Pour une suppression : DELETE FROM recettes WHERE id = :id, avec paramètre. Une interface d’édition demanderait POST, jeton CSRF et contrôle des droits.
Transaction sur plusieurs écritures
Quand plusieurs écritures doivent réussir ensemble, commencer une transaction, valider après la dernière, et annuler en cas d’exception. Un INSERT unique est déjà atomique dans l’atelier.
Exemple
$pdo->beginTransaction();
try {
// Exécuter ici les écritures préparées liées entre elles.
$pdo->commit();
} catch (PDOException $erreur) {
if ($pdo->inTransaction()) { $pdo->rollBack(); }
throw $erreur;
}
Ce canevas explique la séquence ; il ne remplace pas les requêtes du projet.
Les quatre contrôles du formulaire
Valider protège les règles métier ; les paramètres protègent les emplacements SQL ; h protège l’affichage HTML ; le jeton vérifie l’origine attendue du formulaire. Chacun agit à un endroit différent.
Exemple
Entrée → vérifier type et bornes
Écriture → lier les valeurs SQL
Affichage → échapper avec h
Formulaire POST → comparer le jeton de session
Les exemples servent à un atelier local. Une mise en ligne avec écriture partagée doit aussi définir qui peut ajouter, modifier ou supprimer une recette.