How to define array/object in .env file?

Directly defining arrays or objects in a .env file is not natively supported, as .env files are primarily used for storing environment variables in a key-value pair format. However, we can employ techniques to encode arrays or objects as strings. Here are several common methods:

Method 1: Using Comma-Separated Values

For arrays, we can separate each item with commas and then split the string into an array within the application. For example:

plaintext
FOODS=apple,banana,orange

In the application, you can use the following code to convert the string into an array (using Node.js as an example):

javascript
const foods = process.env.FOODS.split(',');
console.log(foods); // ['apple', 'banana', 'orange']

Method 2: Using JSON Strings

For more complex arrays or objects, we can encode them as JSON strings and store this string in the .env file. For example:

plaintext
CONFIG={"username":"admin","password":"secret"}

In the application, you can use the following code to parse this JSON string (using Node.js as an example):

javascript
const config = JSON.parse(process.env.CONFIG);
console.log(config); // { username: 'admin', password: 'secret' }

Example Application

Suppose we have a Node.js application where we want to configure a database connection object. We can define it in the .env file as follows:

plaintext
DATABASE_CONFIG={"host":"localhost","port":3306,"username":"user","password":"password"}

Then, in the application, we can use it like this:

javascript
require('dotenv').config();
const dbConfig = JSON.parse(process.env.DATABASE_CONFIG);
const { host, port, username, password } = dbConfig;
// Proceed to use these configurations to connect to the database

Although this method does not visually represent the structure in the .env file, it effectively utilizes complex data structures through simple conversions within the application.