Données

Qu'est-ce qu'un fichier .env ?

.env est un nom de fichier texte conventionnel qui permet d'écrire des noms et valeurs de variables d'environnement à charger par des applications ou outils compatibles. Il n'existe pas de spécification universelle : guillemets, commentaires, expansion des variables et priorité par rapport aux variables déjà définies dépendent du lecteur.

.envFichier texte de variables d'environnement

Informations de base

Extension: .env
Type MIME: text/plain
Usage: Configuration de développement et variables d'environnement

Quand choisir ce format

Configuration locale de développement
Chargement de variables par un outil compatible identifié

Quand éviter ce format

Remplacement d'un gestionnaire sécurisé de secrets
Cas exigeant une syntaxe et une expansion identiques dans tous les outils

Usages courants

Gestion des variables d'environnement en développement
Transmission de paramètres aux applications et outils

Caractéristiques

L'affectation KEY=value est largement utilisée
La gestion des commentaires, guillemets et expansions varie selon l'outil
Le fichier n'est pas chargé automatiquement : une application ou un outil doit le lire

Avantages et inconvénients

Avantages

Sépare facilement la configuration de développement du code source
De nombreux frameworks et outils proposent un chargeur

Inconvénients

Sans spécification universelle, syntaxe et priorités ne sont pas totalement compatibles
Des valeurs sensibles peuvent être partagées ou publiées par erreur

Ouvrir et convertir

Comment ouvrir

Ouvrez-le dans un éditeur de texte. Avant de modifier les valeurs, vérifiez où l'application cherche le fichier, la syntaxe acceptée et les règles de remplacement.

Comment convertir

Lors d'une migration vers un autre fichier de variables d'environnement, vérifiez guillemets, valeurs multilignes, commentaires, expansion, valeurs vides et priorités selon les règles de l'outil cible.

Précautions

Il n'existe pas de norme universelle pour .env. Docker Compose, Node.js, python-dotenv et d'autres outils diffèrent par leur syntaxe et leur comportement.
Ne publiez pas dans un dépôt public un fichier contenant des mots de passe ou des clés d'API. Utilisez une gestion des secrets avec contrôle d'accès.
En production, vérifiez quel fichier .env est chargé et comment il s'inscrit dans la priorité des variables d'environnement.

Questions fréquentes

Toutes les applications traitent-elles les fichiers .env de la même façon ?

Non. Le chargement et la syntaxe varient selon l'outil. Consultez la documentation de l'application utilisée.

Formats associés

.gitignore.gitignore est un fichier texte de motifs qui indique à Git d'ignorer des chemins qui ne sont pas encore suivis. Git applique les motifs issus des fichiers .gitignore et d'autres sources d'exclusion selon des règles de priorité. L'ajout d'un motif n'arrête pas le suivi d'un fichier déjà présent dans l'index.Fichier de configuration INIINI est un nom courant pour des fichiers texte de configuration organisés en sections et paires clé-valeur. Il n’existe pas de spécification universelle unique : commentaires, séparateurs, casse des clés et valeurs multilignes varient selon l’application ou l’analyseur.Java PropertiesJava Properties est un format texte ligne par ligne, constitué de paires clé-valeur et principalement utilisé avec l'API Properties et ResourceBundle de Java. L'extension .properties est courante, mais l'encodage dépend de la méthode de lecture et de la version de Java : l'extension ne suffit donc pas à le déterminer.YAMLYAML est une notation lisible pour écrire des mappages, séquences et valeurs scalaires. Ses usages recoupent JSON, mais ce n'est pas un surensemble.JSONJSON est un format texte qui représente des données structurées avec des clés et des valeurs. Il est largement utilisé par les API web et les fichiers de configuration.

Usages et vérifications associés

Où stocker les paramètres et les secrets