PDO — Les bases

Guide 02 / 4

Les essentiels de PDO

Un aide-mémoire expliqué : à quoi sert chaque élément, comment l’écrire et quand l’utiliser.

Résultat attendu :

Choisir et utiliser les éléments essentiels pour réaliser cette étape du blog.

Lecture
0%

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.

php -v
php -m
À retenir :

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.

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';
À retenir :

À 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.

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
À retenir :

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.

$options = [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES => false,
];
À retenir :

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.

$categories = $pdo->query('SELECT id, nom FROM categories ORDER BY nom')->fetchAll();
À retenir :

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.

$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.

$requete = $pdo->prepare('SELECT titre FROM recettes WHERE id = :id');
$requete->bindValue(':id', 1, PDO::PARAM_INT);
$requete->execute();
À retenir :

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.

$recette = $requete->fetch();
if ($recette === false) {
    http_response_code(404);
    exit("Recette introuvable.");
}
À retenir :

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.

$requete = $pdo->prepare('SELECT titre FROM recettes WHERE titre LIKE :recherche');
$requete->execute(['recherche' => '%' . $q . '%']);
À retenir :

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.

$requete = $pdo->query('SELECT COUNT(*) FROM recettes');
$total = (int) $requete->fetchColumn();
À retenir :

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.

$requete = $pdo->prepare(
    'INSERT INTO categories (nom) VALUES (:nom)'
);
$requete->execute(['nom' => 'Goûter']);
$id = (int) $pdo->lastInsertId();
À retenir :

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.

$pdo->beginTransaction();
$requete = $pdo->prepare('UPDATE recettes SET duree_minutes = :duree WHERE id = :id');
$requete->execute(['duree' => 25, 'id' => 1]);
$pdo->rollBack();
À retenir :

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.

$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;
}
À retenir :

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.

Entrée → vérifier type et bornes
Écriture → lier les valeurs SQL
Affichage → échapper avec h
Formulaire POST → comparer le jeton de session
À retenir :

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.