33 lines
1.9 KiB
Markdown
33 lines
1.9 KiB
Markdown
# Fichiers .env
|
|
|
|
`.env`, `.env.local`, `.env.<env>`, `.env.<env>.local`, `.env.dist`, le `.env.example` de Laravel et les fichiers Compose `*.env` s'ouvrent
|
|
dans l'**éditeur .env** : **Code**, **Table**, **Split**, **Variables** et, pour Symfony, **Vault** (les boutons en bas à droite).
|
|
|
|
## Code
|
|
|
|
Couleurs pour les noms, valeurs, commentaires, `${REFS}` et guillemets ; complétion des variables que connaissent Symfony et Laravel,
|
|
des `${REFS}` et d'exemples de DSN (`DATABASE_URL=`, `MAILER_DSN=`…) ; marqueurs pour les noms invalides, les guillemets non fermés, un
|
|
nom défini deux fois, un secret dans un fichier que git suit.
|
|
|
|
## Table
|
|
|
|
Les variables du fichier avec leur valeur effective pour dev / test / prod. Renommer, modifier, commenter, ajouter, supprimer,
|
|
**Move to** un autre fichier, **Copy to** le fichier d'un environnement. Les valeurs sont éditées selon leur nature : booléens, nombres,
|
|
texte multiligne, et DSN avec un **DSN builder** (pilote, utilisateur, mot de passe, hôte, port, base, options). Une valeur qu'un autre
|
|
fichier remplace est barrée, avec le fichier qui l'emporte. Chaque modification ne réécrit que les lignes de cette variable.
|
|
|
|
## Variables
|
|
|
|
Les fichiers du dossier fusionnés dans l'ordre où l'application les charge (Symfony : `.env`, `.env.local`, `.env.<env>`,
|
|
`.env.<env>.local` ; Laravel : `.env.<env>` ou `.env`), avec l'origine de chaque valeur. Les références sont résolues.
|
|
|
|
## Secrets
|
|
|
|
Les noms contenant PASSWORD, SECRET, TOKEN, KEY… sont masqués (l'œil les montre). Un vrai secret dans un fichier suivi par git est un
|
|
avertissement avec **Move them to .env.local** en un clic (et `.gitignore` complété).
|
|
|
|
## Vault (Symfony)
|
|
|
|
Les secrets de `config/secrets/<env>/` : révéler à la demande, ajouter / modifier (la valeur va sur l'entrée standard de la commande,
|
|
jamais sur une ligne de commande), supprimer, générer ou renouveler les clés. Une clé de déchiffrement suivie par git est une
|
|
bannière de danger.
|