ap2i/doc/env.md

Gestion des variables d'environnement

Les variables d'environnement sont définies dans les fichiers .env (dotenv)

Voir https://symfony.com/doc/current/configuration.html#configuration-based-on-environment-variables

Principe général

Les fichiers dotenv s'organisent ainsi :

• Un fichier .env commun à tous les environnements, il définit des valeurs par défaut.
• Un fichier .env.local, non versionné, qui surcharge le fichier .env avec les données propres à l'environnement local.

Il existe d'autres manières de surcharger le fichier d'environnement, mais elles ne nous seront pas utiles ici.

Mise en pratique

On trouve dans le répertoire env des fichiers .env.<environnement> correspondant aux différents environnements de développement, test, production, etc.

Lorsque la commande composer install|update est exécutée, la commande bin/console ot:setup:env s'exécute en post- script et génère un symlink .env.local à la racine du projet.

Pour forcer la mise à jour du fichier d'environnement :

bin/console ot:setup:env

Ce symlink pointe vers le fichier d'environnement correspondant à la machine hôte.

On peut forcer un nom d'hôte avec l'option --host. Ex :

bin/console ot:setup:env --host=ci

Déboguer

Les variables d'environnement actives peuvent être affichées au moyen de la commande :

php bin/console debug:container --env-vars