Comment utiliser les variables d'environnement dans Node.js

Cet article a été mis à jour en juillet 2025

Introduction

Les variables d'environnement jouent un rôle crucial dans la configuration et la sécurisation des applications Node.js. Elles permettent aux développeurs de stocker des informations sensibles, des paramètres de configuration et d'autres variables en dehors de la base de code, ce qui facilite la gestion des différents environnements de déploiement (développement, test, production) sans exposer d'informations sensibles.

Dans cet article de blog, nous allons explorer comment utiliser les variables d'environnement dans Node.js, en abordant des sujets tels que la définition, l'accès et la gestion de ces variables dans vos applications.

Comprendre les variables d'environnement

Les variables d'environnement sont des valeurs dynamiques qui peuvent affecter le comportement d'un processus en cours d'exécution. En Node.js, vous pouvez accéder aux variables d'environnement à l'aide de l'objet process.env pour accéder aux variables d'environnement. Ces variables sont définies en dehors de votre application et lues par votre application pendant l'exécution.

Définition des variables d'environnement

Pour définir les variables d'environnement, vous pouvez utiliser différentes méthodes en fonction de votre système d'exploitation ou de votre plateforme de déploiement.

Fenêtres (Invite de commande) - set VAR_NAME=value

Linux et macOS (Shell Bash) - export VAR_NAME=value

L'utilisation d'un.env Fichier

Dans de nombreux projets Node.js, les développeurs utilisent un fichier .env pour stocker et gérer les variables d'environnement.

Créez un fichier nommé .env à la racine de votre projet et définissez vos variables :

DB_HOST=localhost
DB_PORT=5432
SECRET_KEY=mysecretkey

Ce fichier ne doit pas être enregistré dans le système de contrôle des versions afin de garantir que les informations sensibles restent toujours sur votre ordinateur local.

Ajouter .env à votre fichier .gitignore pour éviter qu'il ne soit validé. Voici un fichier d'exemple dans lequel l'ajout a déjà été effectué. Vous pouvez également utiliser dotenv pour une configuration avancée et il chargera automatiquement les variables d'environnement d'un fichier .env dans le fichier process.env. Note : vous pouvez utiliser l'option dotenv pour importer le fichier dans votre code)

Accès aux variables d'environnement dans Node.js

Une fois que vous avez défini vos variables d'environnement, vous pouvez y accéder dans votre application Node.js à l'aide de la commande process.env.

const dbHost = process.env.DB_HOST;
const dbPort = process.env.DB_PORT;
const secretKey = process.env.SECRET_KEY;

console.log(`Database Host: ${dbHost}`);
console.log(`Database Port: ${dbPort}`);
console.log(`Secret Key: ${secretKey}`);

Utilisation d'un module pour les variables d'environnement

Pour une meilleure organisation, envisagez de créer un module pour centraliser l'accès aux variables d'environnement. Créez un fichier nommé config.js:

module.exports = {
  dbHost: process.env.DB_HOST,
  dbPort: process.env.DB_PORT,
  secretKey: process.env.SECRET_KEY,
};

Désormais, vous pouvez facilement importer et utiliser ces variables dans d'autres parties de votre application :

const config = require('./config');

console.log(`Database Host: ${config.dbHost}`);
console.log(`Database Port: ${config.dbPort}`);
console.log(`Secret Key: ${config.secretKey}`);

Traitement des valeurs par défaut

Parfois, vous pouvez fournir des valeurs par défaut pour les variables d'environnement si elles ne sont pas définies. Pour ce faire, vous pouvez utiliser l'opérateur || pour ce faire :

const dbHost = process.env.DB_HOST || 'localhost';
const dbPort = process.env.DB_PORT || 5432;
const secretKey = process.env.SECRET_KEY || 'defaultsecret';

Synthèse

Utiliser efficacement les variables d'environnement dans vos applications Node.js est crucial pour maintenir la sécurité et la configurabilité. En gardant les informations sensibles en dehors de votre base de code et en utilisant une approche standardisée, vous pouvez facilement gérer différents environnements de déploiement et garantir une application plus sûre.

N'oubliez pas de faire preuve de prudence avec les informations sensibles et de suivre les meilleures pratiques pour sécuriser vos variables d'environnement, en particulier dans les environnements de production.

Si vous avez des questions, rejoignez-nous sur le Slack des développeurs de Vonage ou envoyez-nous un message sur Xet nous vous répondrons. Merci encore d'avoir lu, et je vous retrouverai dans le prochain numéro !