Ditch dotenv : Node.js prend désormais en charge nativement le chargement de fichiers .env

L'un des éléments essentiels de la gestion de l'environnement dans Node.js a été l'utilisation du package dotenv, qui facilite le chargement de variables d'environnement à partir d'un fichier .env. Cependant, les mises à jour récentes de Node.js ont introduit des fonctionnalités intégrées qui peuvent réduire ou éliminer le besoin de packages externes tels que dotenv pour gérer les variables d'environnement.

Gestion des fichiers .env natifs

À partir de la version 20.6.0, Node.js permet l'utilisation de l'indicateur --env-file lors de l'exécution de scripts. Cet indicateur spécifie un chemin d'accès à un fichier .env que Node.js lira avant d'exécuter le script spécifié. Cette approche rationalise le processus de définition des variables d'environnement, le rendant plus intégré et moins dépendant des packages tiers.

Considérez un scénario dans lequel vous disposez de la configuration d'environnement suivante :

# .env file
NODE_OPTIONS='--title="Sample Node App"'
USER_NAME='John Doe'

Pour exécuter un script Node.js en utilisant cette configuration, vous utiliserez :

node --env-file=.env your-script.js

Dans your-script.js, l'accès à ces variables peut se faire comme suit :

console.log(process.title); // Outputs: Sample Node App
console.log(`Hello, ${process.env.USER_NAME}`); // Outputs: Hello, John Doe

Chargement simplifié avec process.loadEnvFile()

S'appuyant sur la prise en charge initiale, Node.js version 21.7.0 a introduit la méthode process.loadEnvFile(). Cette fonction simplifie le chargement des variables d'environnement en les incorporant dans le processus d'exécution sans avoir besoin d'indicateurs de ligne de commande.

Vous pouvez charger les variables d'environnement par programme dans votre application comme indiqué ci-dessous :

process.loadEnvFile(); // Automatically loads `.env` from the current directory
​
// Or specify a path
process.loadEnvFile('./config/env_vars.env');

Analyse des variables d'environnement

En plus du chargement des variables d'environnement, Node.js 21.7.0 a introduit util.parseEnv(), une fonction utilitaire qui analyse une chaîne contenant des définitions de variables d'environnement dans un objet.

Voici comment utiliser util.parseEnv() :

const util = require('node:util');
const envVars = util.parseEnv('API_KEY=12345');
console.log(envVars.API_KEY); // Outputs: 12345

Prise en charge des valeurs multilignes dans les fichiers .env

Une autre fonctionnalité de Node.js 21.7.0 est la prise en charge des valeurs multilignes dans les fichiers .env :

CERTIFICATE="-----BEGIN CERTIFICATE-----
MIIDdTCCAl2gAwIBAgIJAKC1hi9s2wfMM...
-----END CERTIFICATE-----"

Vous pouvez désormais inclure de telles chaînes multilignes directement dans vos fichiers .env, ce qui rend la gestion des configurations complexes plus propre et plus simple.

Conclusion

La prise en charge native des fichiers .env introduite dans le dernier Node.js permet à votre projet d'être mis en place plus rapidement et réduit les dépendances sur des packages externes tels que dotenv.

Si vous avez trouvé cela utile, pensez à à vous abonner à ma newsletter pour des articles et des outils plus utiles sur le développement Web. Merci d'avoir lu !

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!