## 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

Ou en définissant une variable d'environnement `HOST` :

    HOST=ci bin/console ot:setup:env

### Déboguer

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

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