Les variables d'entorn són una manera de configurar aplicacions sense haver de modificar el codi font. Aquestes variables es poden utilitzar per emmagatzemar informació sensible com ara claus d'API, cadenes de connexió a bases de dades, i altres configuracions que poden variar entre diferents entorns (desenvolupament, proves, producció).

1. Què són les variables d'entorn?

   • Són variables externes al codi de l'aplicació que poden influir en el comportament del programa.
   • Es defineixen en el sistema operatiu o en fitxers de configuració.

2. Per què utilitzar variables d'entorn?

   • Seguretat: Eviten que informació sensible estigui codificada directament en el codi font.
   • Flexibilitat: Permeten canviar configuracions sense necessitat de modificar el codi.
   • Portabilitat: Faciliten el desplegament de l'aplicació en diferents entorns amb configuracions específiques.

Les variables d'entorn es poden definir de diverses maneres, depenent del sistema operatiu i del context en què s'executa l'aplicació.

En Linux/MacOS

En Windows

En Node.js, les variables d'entorn es poden accedir a través de l'objecte process.env.

Una pràctica comuna és utilitzar un fitxer .env per definir les variables d'entorn. Aquest fitxer es carrega en l'entorn d'execució de l'aplicació utilitzant una biblioteca com dotenv.

Instal·lació de dotenv

Crear un fitxer .env

Carregar el fitxer .env en l'aplicació

1. Crea un fitxer .env amb les següents variables:

   APP_NAME=MyNodeApp
   APP_VERSION=1.0.0
   

2. Instal·la la biblioteca dotenv si no ho has fet ja:

   npm install dotenv
   

3. Crea un fitxer index.js i carrega les variables d'entorn:

   require('dotenv').config();
   
   const appName = process.env.APP_NAME;
   const appVersion = process.env.APP_VERSION;
   
   console.log(`Application Name: ${appName}`);
   console.log(`Application Version: ${appVersion}`);
   

4. Executa l'aplicació:

   node index.js
   

1. Crea un fitxer .env amb les següents variables:

   PORT=4000
   

2. Crea un fitxer server.js i configura un servidor HTTP utilitzant la variable d'entorn PORT:

   require('dotenv').config();
   const http = require('http');
   
   const port = process.env.PORT || 3000;
   
   const server = http.createServer((req, res) => {
       res.statusCode = 200;
       res.setHeader('Content-Type', 'text/plain');
       res.end('Hello, World!\n');
   });
   
   server.listen(port, () => {
       console.log(`Server running at http://localhost:${port}/`);
   });
   

3. Executa l'aplicació:

   node server.js
   

• Error: Variable d'entorn no definida: Assegura't que has carregat el fitxer .env correctament amb dotenv.config().
• Error: Fitxer .env no trobat: Verifica que el fitxer .env es troba en el directori arrel del projecte.
• Consell: No incloguis el fitxer .env en el control de versions (afegiu-lo a .gitignore) per evitar exposar informació sensible.

Les variables d'entorn són una eina poderosa per gestionar configuracions sensibles i específiques d'entorn en aplicacions Node.js. Utilitzant biblioteques com dotenv, podem simplificar la gestió d'aquestes variables i assegurar-nos que la nostra aplicació sigui segura i fàcil de configurar en diferents entorns.