Comment ignorer .env mais conserver .env.example ?

Gardez les valeurs réelles hors du suivi et partagez un .env.example vérifié avec des valeurs fictives. Vérifiez les conventions du framework avant une règle trop large.

1. Exclure les valeurs locales, conserver l’exemple

Ces règles dans le .gitignore racine excluent .env et les fichiers racine commençant par .env., puis réincluent .env.example. Elles ne couvrent ni service.env ni les sous-dossiers.

Vérifiez .env.example avant de le valider : son nom ne garantit pas l’absence de secrets. Utilisez des valeurs fictives et documentez les variables nécessaires.

/.env
/.env.*
!/.env.example

2. Vérifier les trois cas

Avec .env, .env.local et .env.example non suivis, examinez les règles correspondantes :

git check-ignore -v -- .env .env.local .env.example

!/.env.example signifie que l’exemple est réinclus. L’état doit le lister sans les deux fichiers de valeurs locales. Un parent exclu ou une règle ultérieure peut changer le résultat.

git status --short --untracked-files=all -- .env .env.local .env.example

Pourquoi ! ne conserve-t-il pas un fichier dans un dossier ignoré ?

3. Traiter les valeurs déjà suivies

Vérifiez si Git suit déjà l’un des fichiers de valeurs locales :

git ls-files -- .env .env.local

Si des chemins apparaissent, suivez l’article sur les fichiers suivis et coordonnez le changement. .gitignore ne supprime pas les commits. Révoquez ou remplacez tout identifiant exposé, puis suivez les conseils GitHub ; retirer le fichier actuel n’efface pas l’historique.

Comment ignorer des fichiers déjà suivis par Git ?

Pour le comportement exact et davantage de détails, consultez les références officielles : Documentation Git · FAQ Git · Conseils GitHub en cas de données sensibles exposées