Connecter Doctrine à une base de données PostgreSQL dans un projet Symfony 4 sous Windows

I. Activer les pilotes PostgreSQL

Pour commencer, il faut activer les pilotes PostgreSQL pour permettre à PHP d’accéder aux bases de données PostgreSQL.

Les pilotes pgsql et pdo_pgsql sont nécessaires.

Si vous utilisez une solution comme WAMP, Laragon, Easy PHP, les pilotes sont simplement désactivés et les fichiers DLL nécessaires sont présents dans le répertoire ‘ext’ de votre dossier php utilisé.

Si vous n’utilisez pas ce type de solution pouvez installer les pilotes manuellement: https://www.php.net/manual/fr/install.pecl.windows.php

Dans tous les cas, il faut dé-commenter les lignes suivantes dans votre fichier de configuration php.ini:

Note: pour localiser votre fichier php.ini utilisé, vous pouvez ouvrir un terminal dans le dossier de votre projet php et taper la commande php –ini.

Pour s’assurer de l’activation de ces pilotes, vous pouvez tapez la commande « php -i« . Si tout s’est bien passé, vous devriez voir apparaître ces lignes dans la sortie :

II. Configurer Symfony

Il faut se rendre dans le fichier doctrine.yml situé à la racine de votre projet dans config/packages.

Remplacez le driver utilisé par pdo_pgsql et les références à utf8mb4 (qui est l’encodage par défaut de MySQL) en utf8:

III. Connexion ou création de la base de données

Dans tous les cas, ouvrez le fichier .env situé à la racine de votre projet.

Changez la constante DATABASE_URL par les données adéquates:

Note: le port 5432 est le port par défaut utilisé par PostgreSQL.

Le nom de la base de données peut faire référence à la base de données à laquelle vous souhaitez vous connecter ou alors au nom de la base de données que vous souhaitez créer.

Si vous souhaitez créer la base de données exécutez la commande à la racine de votre projet:

php bin/console doctrine:database:create

IV. Vérification que la connexion est établie

Il y a probablement des moyens plus élégants de le faire (n’hésitez pas à le dire en commentaire si vous en connaissez 😉 ) mais pour tester le fait que la connexion est fonctionnelle, vous pouvez exécuter à la racine de votre projet la commande:

  php bin/console doctrine:query:sql 'SELECT 1'  

S’il n’y a pas d’erreur, c’est que vous êtes bien connecté! 🙂