Ajout des commentaires dans le code

db.php

@@ -2,6 +2,21 @@
 
 declare(strict_types=1);
 
+/**
+ * Ouverture de la connexion PDO à MariaDB.
+ *
+ * Trois options structurantes, dont dépend tout le reste du code :
+ *  - ERRMODE_EXCEPTION : une requête en échec lève, elle ne renvoie pas false.
+ *    Aucun appel PDO n'est donc testé manuellement dans les modèles.
+ *  - FETCH_ASSOC par défaut : les modèles indexent partout par nom de colonne.
+ *  - EMULATE_PREPARES = false : requêtes réellement préparées côté serveur, ce
+ *    qui donne des types entiers natifs en retour et ferme la porte aux
+ *    contournements d'échappement.
+ *
+ * @return PDO
+ *
+ * @throws RuntimeException Si la connexion échoue (message volontairement neutre).
+ */
 $config = require __DIR__ . '/config.php';
 $db = $config['db'];