Symfony - 4.6 Symfony : introduction à Doctrine et aux bases de données

Dans les leçons sur le modèle, les objets stockés en base de données s'appellent des entités. Pour communiquer avec la base, Symfony utilise Doctrine. Cette leçon explique son rôle et la façon de vérifier sa configuration avant de créer la base.

Le rôle du modèle et des entités

Le modèle sert à stocker des objets, appelés entités, dans une base de données relationnelle.

Doctrine fournit son propre langage pour accéder aux bases de données. Il facilite aussi la modification de la base au fil de l'évolution du projet.

Installer et vérifier Doctrine

Si Doctrine n'est pas encore installé, lancez la commande suivante dans le terminal. Une fois l'installation faite, vous retrouvez Doctrine dans votre projet.

La configuration se vérifie dans le fichier .env. À la dernière ligne, le nom par défaut de la base, « app », doit être remplacé par le nom de votre projet.

composer require doctrine

Tester Doctrine dans le terminal

Dans le terminal, la commande suivante affiche les commandes que Doctrine propose.

Si la création d'une base de données affiche un message d'erreur, l'utilisateur de la base n'a probablement pas le droit d'en créer une.

php bin/console doctrine

En résumé

Doctrine fait le lien entre votre code PHP et la base de données. Les entités représentent les données stockées. Avant de créer la base, vérifiez la configuration dans le fichier .env et les droits de l'utilisateur de la base.

Points clés

  • Le modèle stocke des objets, appelés entités, dans une base relationnelle.
  • Doctrine fournit un langage pour accéder aux bases de données.
  • Doctrine s'installe avec Composer.
  • La connexion à la base se configure dans le fichier .env.
  • Une erreur à la création de la base indique souvent un manque de droits.

Questions fréquentes

Qu'est-ce que Doctrine ?

Doctrine est un cadre qui permet d'accéder à différentes bases de données avec son propre langage. Il facilite aussi les modifications de la base.

Où configure-t-on la connexion à la base ?

La connexion se configure dans le fichier .env, à la dernière ligne. Il faut y remplacer le nom par défaut de la base par celui de votre projet.

Que faire si la base ne se crée pas ?

Vérifiez que l'utilisateur de la base a le droit d'en créer une. Le message d'erreur l'indique souvent.