symfony/dotenv

Registers environment variables from a .env file

Maintainers

Package info

github.com/symfony/dotenv

Homepage

pkg:composer/symfony/dotenv

Fund package maintenance!

fabpot

nicolas-grekas

symfony.com/sponsor

Tidelift

Statistics

Installs: 240 033 976

Dependents: 2 627

Suggesters: 23

Stars: 3 793

Security

Advisories: 0

Aikido package health analysis

v8.1.0 2026-05-29 05:06 UTC

Requires

  • php: >=8.4.1

Requires (Dev)

MIT 7ed4e3a11e3c98235c70ded047d7ddf9e6ae854c

environmentenvdotenv

This package is auto-updated.

Last update: 2026-06-05 06:51:18 UTC

README

Symfony Dotenv parses .env files to make environment variables stored in them accessible via $_SERVER or $_ENV.

Getting Started

composer require symfony/dotenv

Usage

For an .env file with this format:

YOUR_VARIABLE_NAME=my-string
use Symfony\Component\Dotenv\Dotenv;

$dotenv = new Dotenv();
$dotenv->load(__DIR__.'/.env');

// you can also load several files
$dotenv->load(__DIR__.'/.env', __DIR__.'/.env.dev');

// overwrites existing env variables
$dotenv->overload(__DIR__.'/.env');

// loads .env, .env.local, and .env.$APP_ENV.local or .env.$APP_ENV
$dotenv->loadEnv(__DIR__.'/.env');

// Usage with $_ENV
$envVariable = $_ENV['YOUR_VARIABLE_NAME'];

// Usage with $_SERVER
$envVariable = $_SERVER['YOUR_VARIABLE_NAME'];

Sponsor

This package is looking for a backer.

Help Symfony by sponsoring its development!

Resources