Vérifier les environnements

Générateur .env.example

Préparez les noms à renseigner, puis contrôlez ce qui reste dans le modèle.

Générateur .env.example

Source .env

Aperçu .env.example

Traitement dans le navigateur. Les saisies restent en mémoire, sans URL, télémétrie ni historique local.

Options du modèle

Affectations : 5 · Remplacées : 5 · Conservées : 0 · Doublons : 0 · Commentaires d’origine : 2

Les commentaires, descriptions et valeurs conservées peuvent contenir des secrets. L’outil ne garantit pas que ce fichier peut être publié.

Un modèle utile doit expliquer ce que le projet attend sans reprendre sa configuration de travail. Le Générateur .env.example part de vos affectations existantes : il garde les noms et retire les valeurs par défaut. Vous choisissez ensuite les quelques exceptions à transmettre.

Une clé privée entre guillemets peut occuper plusieurs lignes. La traiter ligne par ligne avec un simple remplacement risque de laisser un fragment derrière elle. Ici, les valeurs citées sont lues entièrement avant modification ; une erreur de syntaxe interrompt la génération.

Pourquoi choisir ce Générateur .env.example ?

Garder la structure du projet

Le Générateur .env.example conserve la succession des variables, les lignes vides et les noms répétés. Vous retrouvez les groupes que vous aviez organisés plutôt qu’une liste réordonnée. Les commentaires d’origine restent activés par défaut et méritent une relecture.

Deux panneaux conservent les mêmes repères de variables et de commentaires, tandis que les cases de valeurs deviennent vides.

Expliquer les valeurs conservées

Un port de développement peut être utile à l’équipe. Inscrivez son nom exact parmi les exceptions, puis ajoutez une description de son usage. La conservation résulte de votre choix, jamais d’une supposition selon laquelle les nombres seraient sans risque.

Une ligne sélectionnée conserve sa valeur ; des barres de description apparaissent au-dessus des affectations.

Préparer les choix avant le partage

01

Distinguer exemple et valeur utilisable

Le mode vide laisse KEY=. Le mode de remplacement inscrit un texte entre guillemets. Ces placeholders invitent à compléter le fichier ; ils ne génèrent ni mot de passe valide ni valeurs de démonstration adaptées à un service.

02

Vérifier les noms exacts

Les exceptions distinguent majuscules et minuscules. Une description prend la forme KEY=description, une seule fois par nom. Les noms absents de la source sont signalés afin que vous puissiez corriger une faute de frappe.

03

Relire après un ajustement

L’aperçu automatique attend 350 ms. Désactivez-le pour lancer avec Ctrl/Cmd + Enter. Toute modification annule la confirmation de relecture ; copie et téléchargement demandent un résultat à jour et une nouvelle confirmation.

Du contexte sans recopier tous les réglages

Toutes les déclarations restent visibles

Les affectations vides sont conservées, comme les préfixes export. Si un nom apparaît deux fois, les deux lignes restent présentes et suivent la même politique de remplacement. Les compteurs permettent de distinguer affectations, valeurs conservées et doublons.

Un remplacement correctement cité

Un texte personnalisé peut contenir des guillemets ou des barres obliques inverses : ils sont échappés dans la valeur produite. Le texte doit toutefois être non vide et tenir sur une ligne sans caractères de contrôle. Il ne peut pas introduire une deuxième affectation.

Des descriptions indépendantes

Chaque description devient une ligne commençant par # avant les occurrences du nom concerné. Vous pouvez donc retirer les anciens commentaires tout en ajoutant des explications neuves sur les variables d’environnement. Les lignes vides restent en place.

Ce que le résultat ne garantit pas

Aucun certificat d’absence de secrets
Une valeur inscrite dans les exceptions reste telle quelle. Les commentaires et descriptions peuvent eux aussi contenir des données confidentielles. L’outil ne détecte pas ces secrets et ne décide pas si votre fichier mérite d’être ajouté à Git.
Des limites de syntaxe explicites
Les noms acceptent les lettres ASCII, chiffres et tirets bas, sans chiffre initial. Les chaînes citées peuvent couvrir plusieurs lignes. Un guillemet non fermé, un caractère NUL ou une affectation incorrecte bloque le résultat. Source et sortie sont limitées à 1 MiB chacune, avec 10 000 affectations au plus en entrée.
Pas de découverte du projet
Le Générateur .env.example travaille uniquement sur le texte fourni. Il ne cherche pas les noms manquants dans le code, ne fusionne pas un autre modèle et ne supprime pas les doublons. Les références comme ${HOST} restent littérales dans les valeurs conservées ; aucun code n’est exécuté.
Une description par nom
La liste des descriptions refuse les noms répétés, les lignes incorrectes et les caractères de contrôle. Un nom inconnu est signalé sans devenir une nouvelle variable. Le fichier utilise des fins de ligne LF et ne promet pas de reproduire tous les espaces de la source.

Questions sur le Générateur .env.example

Faut-il versionner le fichier exemple ?

Un fichier exemple peut servir de documentation commune dans le dépôt. Avant de le versionner, retirez tout contenu confidentiel, y compris dans les commentaires et les exceptions. La génération et la case de relecture ne prouvent pas que le résultat est publiable.

Les commentaires restent-ils dans le résultat ?

Oui, par défaut : les commentaires sur leur propre ligne et ceux placés après une valeur restent présents. L’option correspondante les retire ensemble. Les descriptions ajoutées dans leur champ séparé constituent de nouveaux commentaires et ne dépendent pas de cette option.

Peut-on choisir le texte de remplacement ?

Oui. Choisissez le mode de remplacement et fournissez un texte non vide sur une ligne. Les guillemets et barres obliques inverses sont encodés. Les clés explicitement conservées échappent à ce remplacement et gardent leur valeur d’origine.

Que deviennent les valeurs vides ?

Une affectation KEY= reste dans le fichier. En mode vide, elle reste vide. En mode de remplacement, elle reçoit le texte choisi, sauf si son nom figure parmi les exceptions. Elle n’est jamais supprimée sous prétexte qu’elle ne contient pas encore de valeur.

Les valeurs citées sont-elles acceptées ?

Les guillemets simples et doubles sont pris en charge dans le sous-ensemble décrit, ainsi que les valeurs citées sur plusieurs lignes. Les valeurs remplacées sont traitées entièrement. Un guillemet manquant provoque une erreur et bloque l’export, au lieu de produire un fichier partiel.

Une question sur une valeur ou une règle ?

Donnez à l’équipe un modèle à compléter

Le Générateur .env.example prépare une liste lisible des réglages attendus. Revoyez les exceptions et les commentaires dans l’aperçu complet avant de partager.