README

Loads contents from a .env file into the environment. PHP 8.1+

Documentation

Installation

requires composer

composer.json (note: replace dev-main with a version constraint, e.g. ^3.0)

{ "require": { "php": "^8.1", "chillerlan/php-dotenv": "dev-main" } }

Installation via terminal: composer require chillerlan/php-dotenv

Profit!

Usage

# example .env FOO=bar BAR=foo WHAT=${BAR}-${FOO} 

$env = new DotEnv(__DIR__.'/../config', '.env'); $env->load(['foo']); // foo is required // get a variable $foo = $_ENV['FOO']; // -> bar $foo = $env->get('FOO'); // -> bar $foo = $env->FOO; // -> bar // dynamically set a variable $env->set('foo', 'whatever'); $env->FOO = 'whatever'; $foo = $env->get('FOO'); // -> whatever // ... // variable substitution $foo = $env->get('WHAT'); // -> foo-bar

// avoid the global environment $env = (new DotEnv(__DIR__.'/../config', '.env', false))->load(); $foo = $_ENV['FOO']; // -> undefined $foo = $env->get('FOO'); // -> bar $foo = $env->FOO; // -> bar