solophp/dotenv

Simple, zero-dependency .env loader for PHP. Loads files into $_ENV with optional $_SERVER population.

v1.0.0 2025-08-19 12:50 UTC

Requires

• php: ^8.0

Requires (Dev)

• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^10.5
• squizlabs/php_codesniffer: ^3.10

MIT

• Vitaliy Olos

• php
• psr
• env
• dotenv
• strict-types
• php8

README

Simple, zero-dependency .env loader for PHP. Loads environment variables from files into $_ENV (optionally also $_SERVER). No global putenv calls, no magic variable expansion.

Features

• Small and focused: just parsing and loading
• Zero dependencies
• Deterministic overrides: later files in the same call override earlier ones
• Typed accessors: string, int, bool, and required

Installation

composer require solophp/dotenv

Quick start

use Solo\Dotenv\Dotenv;

Dotenv::load(__DIR__, ['.env', '.env.local']);

$dbDsn = Dotenv::required('DB_DSN');
$isDebug = Dotenv::bool('APP_DEBUG', false);

API

• Dotenv::load(string $baseDir, array $filenames = ['.env', '.env.local'], bool $overwrite = false, bool $populateServer = false): void
  • Loads files in order. Existing environment variables set before the call are preserved by default. Variables set by earlier files in the same call can be overridden by later files.
  • Set $overwrite = true to overwrite any existing $_ENV values.
  • Set $populateServer = true to mirror values into $_SERVER.
• Dotenv::get(string $key, mixed $default = null): mixed
• Dotenv::string(string $key, string $default = ''): string
• Dotenv::int(string $key, int $default = 0): int
• Dotenv::bool(string $key, bool $default = false): bool
• Dotenv::required(string $key): string — throws InvalidArgumentException if missing/empty.

Parser

The parser is implemented in Solo\Dotenv\EnvParser and supports:

• Lines like KEY=VALUE
• Optional leading export
• Single and double quotes
• Inline comments for unquoted values (FOO=bar # comment)
• No variable expansion (by design)

Testing

composer install
composer test

License

MIT