Articolo originale: How to Use Node Environment Variables with a DotEnv File for Node.js and npm
Le variabili di ambiente sono variabili che vengono impostate al di fuori di un programma, spesso tramite un cloud provider o un sistema operativo.
In Node, le variabili di ambiente sono un ottimo strumento per configurare in modo sicuro e conveniente cose che non cambiano spesso, come URL, chiavi di autenticazione e password.
Come creare variabili d'ambiente
Le variabili di ambiente sono supportate nativamente in Node e sono accessibili tramite l'oggetto env (che è una proprietà dell'oggetto globale process).
Per vederla in azione, puoi creare la tua variabile di ambiente direttamente nel REPL di Node aggiungendo una variabile direttamente all'oggetto process.env.
Ad esempio, per creare una variabile d'ambiente per memorizzare la combinazione sul mio bagaglio potrei assegnare la variabile in questo modo: process.env.LUGGAGE_COMBO=“12345”.
(Una piccola parentesi: le variabili di ambiente sono, per convenzione, generalmente scritte in maiuscolo.)
Sebbene questo sia a puro titolo d'esempio, non userai mai REPL di Node in questo modo in un'app. Per creare variabili di ambiente nella tua app Node, probabilmente vorrai usare un pacchetto come DotEnv.
Come usare DotEnv
DotEnv è un piccolo pacchetto npm che carica automaticamente le variabili di ambiente da un file .env nell'oggetto process.env.
Per utilizzare DotEnv, prima bisogna installarlo utilizzando il comando: npm i dotenv. Quindi nella tua app, richiedi e configura il pacchetto in questo modo: require('dotenv').config().
Tieni presente che alcuni pacchetti come Create React App includono già DotEnv e i provider di servizi cloud potrebbero disporre di metodi diversi per impostare le variabili di ambiente. Quindi assicurati di controllare la documentazione sia per i pacchetti che per provider che stai utilizzando prima di seguire qualsiasi consiglio di questo articolo.
Come creare un file .env
Dopo aver installato e configurato DotEnv, crea un file chiamato .env al livello più alto della struttura dei file. Qui è dove dichiarerai tutte le tue variabili d'ambiente, scritte nel formato NAME=value . Ad esempio, puoi impostare una variabile di porta su 3000 in questo modo: PORT=3000.
Puoi dichiarare più variabili nel file .env. Ad esempio, puoi impostare variabili di ambiente relative al database come queste:
DB_HOST=localhost
DB_USER=admin
DB_PASSWORD=passwordNon è necessario racchiudere le stringhe tra virgolette. DotEnv lo fa automaticamente per te.
Una volta creato questo file, ricorda che non dovresti inviarlo a GitHub poiché può contenere dati sensibili come chiavi di autenticazione e password. Aggiungi il file a .gitignore per evitare di inviarlo accidentalmente a un repository pubblico.
Come accedere alle variabili d'ambiente
Accedere alle tue variabili è semplicissimo! Sono attaccati all'oggetto process.env, quindi puoi accedervi usando il modello process.env.KEY.
Se hai bisogno di modificare il valore di una qualsiasi delle tue variabili d'ambiente, devi solo modificare il file .env.
Ricapitolando
Le variabili di ambiente renderanno il tuo codice più gestibile e più sicuro. Sono facili da configurare con DotEnv e semplici da usare in Node.
Ora che sai come si fa, puoi creare le tue variabili di ambiente per la tua applicazione Node. Divertiti!