Simplify PHP Environment Variables with vlucas/phpdotenv

When I started using PHP I missed the easy way to manage environment variables that libraries like Node.js's dotenv provide. The vlucas/phpdotenv package brings that capability to PHP.

Managing Environment Variables

In development we should read values from a local .env file rather than from system-wide variables, making project switching easier and providing a clear list of required settings for collaborators.

.env Files

Typically two files are used:

.env – contains actual values and should be added to .gitignore.

.env-example – lists required keys without values, allowing others to copy and fill them.

Production may use separate configuration mechanisms and not deploy the .env file.

Example .env content:

AWESOME_API_KEY=abc123
AWESOME_API_SECRET=abcdef0123456789

These values can then be accessed in PHP via $_ENV['AWESOME_API_KEY'] etc.

Installing phpdotenv

Add the package with Composer: composer require vlucas/phpdotenv Then load it early in your application, for example in index.php after the autoloader:

$dotenv = new DotenvDotenv(__DIR__);

$dotenv->load();

After loading, all variables defined in .env are available throughout the code.

Using phpdotenv makes handling configuration in PHP as straightforward as using a simple config file.