Ajout des commentaires dans le code

config.php

@@ -2,6 +2,17 @@
 
 declare(strict_types=1);
 
+/**
+ * Configuration de la connexion base de données.
+ *
+ * Toutes les valeurs viennent de variables d'environnement PTA_DB_* (posées par
+ * docker-compose.yml depuis le .env). Les valeurs par défaut ne servent qu'à un
+ * usage local hors Docker : en conteneur, elles sont toujours surchargées.
+ *
+ * Ne jamais écrire de mot de passe en dur ici : ce fichier est versionné.
+ *
+ * @return array{db: array{host: string, port: string, name: string, user: string, pass: string, charset: string}}
+ */
 return [
     'db' => [
         'host' => getenv('PTA_DB_HOST') ?: '127.0.0.1',