PHP-DotEnv is a lightweight and robust PHP library designed to simplify the management of environment variables in your PHP applications. It parses a .env file and loads the variables into getenv(), $_ENV, and $_SERVER.

It comes with a powerful processor system that automatically converts values (booleans, nulls, numbers) and allows you to define your own custom processors for specific needs.

Requires PHP 7.4 or higher.

Install via Composer:

composer require phpdevcommunity/php-dotenv

1. Create a .env file in your project root:

   APP_ENV=dev DATABASE_URL="mysql:host=localhost;dbname=test" DEBUG=true CACHE_TTL=3600 API_KEY=null # This is a comment

2. Load the variables in your PHP entry point (e.g., index.php):

   <?php require 'vendor/autoload.php'; use PhpDevCommunity\DotEnv; $envFile = __DIR__ . '/.env'; // Load environment variables (new DotEnv($envFile))->load(); // Access variables var_dump(getenv('APP_ENV')); // string(3) "dev" var_dump($_ENV['DEBUG']); // bool(true)

PHP-DotEnv automatically processes values using default processors:

• BooleanProcessor: Converts true and false (case-insensitive) to PHP bool.
• NullProcessor: Converts null (case-insensitive) to PHP null.
• NumberProcessor: Converts numeric strings to int or float.
• QuotedProcessor: Removes surrounding double quotes " or single quotes ' from strings.

Lines starting with # are treated as comments and ignored.

Keys and values are automatically trimmed of whitespace.

You can extend the functionality by creating custom processors. A processor must extend PhpDevCommunity\Processor\AbstractProcessor.

Example: A processor that converts comma-separated strings into arrays.

namespace App\Processor; use PhpDevCommunity\Processor\AbstractProcessor; class ArrayProcessor extends AbstractProcessor { public function canBeProcessed(): bool { // Process only if value contains a comma return strpos($this->value, ',') !== false; } public function execute() { return array_map('trim', explode(',', $this->value)); } }

Pass an array of processor class names to the DotEnv constructor. Note: When you pass custom processors, you must also include the default ones if you still want them to run.

use PhpDevCommunity\DotEnv; use PhpDevCommunity\Processor\BooleanProcessor; use PhpDevCommunity\Processor\NullProcessor; use PhpDevCommunity\Processor\NumberProcessor; use PhpDevCommunity\Processor\QuotedProcessor; use App\Processor\ArrayProcessor; $processors = [ BooleanProcessor::class, NullProcessor::class, NumberProcessor::class, QuotedProcessor::class, ArrayProcessor::class // Your custom processor ]; (new DotEnv(__DIR__ . '/.env', $processors))->load();

PHP-DotEnv est une bibliothèque PHP légère conçue pour simplifier la gestion des variables d'environnement dans vos applications PHP. Elle analyse un fichier .env et charge les variables dans getenv(), $_ENV et $_SERVER.

Elle intègre un système de processeurs qui convertit automatiquement les valeurs (booléens, null, nombres) et vous permet de définir vos propres processeurs personnalisés.

Nécessite PHP 7.4 ou supérieur.

Installez via Composer :

composer require phpdevcommunity/php-dotenv

1. Créez un fichier .env à la racine de votre projet :

   APP_ENV=dev DATABASE_URL="mysql:host=localhost;dbname=test" DEBUG=true CACHE_TTL=3600 API_KEY=null # Ceci est un commentaire

2. Chargez les variables dans votre point d'entrée PHP (ex: index.php) :

   <?php require 'vendor/autoload.php'; use PhpDevCommunity\DotEnv; $envFile = __DIR__ . '/.env'; // Charger les variables d'environnement (new DotEnv($envFile))->load(); // Accéder aux variables var_dump(getenv('APP_ENV')); // string(3) "dev" var_dump($_ENV['DEBUG']); // bool(true)

PHP-DotEnv traite automatiquement les valeurs à l'aide de processeurs par défaut :

• BooleanProcessor : Convertit true et false (insensible à la casse) en bool PHP.
• NullProcessor : Convertit null (insensible à la casse) en null PHP.
• NumberProcessor : Convertit les chaînes numériques en int ou float.
• QuotedProcessor : Supprime les guillemets doubles " ou simples ' entourant les chaînes.

Les lignes commençant par # sont traitées comme des commentaires et ignorées.

Les espaces autour des clés et des valeurs sont automatiquement supprimés.

Vous pouvez étendre les fonctionnalités en créant des processeurs personnalisés. Un processeur doit étendre PhpDevCommunity\Processor\AbstractProcessor.

Exemple : Un processeur qui convertit les chaînes séparées par des virgules en tableaux.

namespace App\Processor; use PhpDevCommunity\Processor\AbstractProcessor; class ArrayProcessor extends AbstractProcessor { public function canBeProcessed(): bool { // Traiter uniquement si la valeur contient une virgule return strpos($this->value, ',') !== false; } public function execute() { return array_map('trim', explode(',', $this->value)); } }

Passez un tableau de noms de classes de processeurs au constructeur de DotEnv. Note : Lorsque vous passez des processeurs personnalisés, vous devez également inclure ceux par défaut si vous souhaitez qu'ils continuent de fonctionner.

use PhpDevCommunity\DotEnv; use PhpDevCommunity\Processor\BooleanProcessor; use PhpDevCommunity\Processor\NullProcessor; use PhpDevCommunity\Processor\NumberProcessor; use PhpDevCommunity\Processor\QuotedProcessor; use App\Processor\ArrayProcessor; $processors = [ BooleanProcessor::class, NullProcessor::class, NumberProcessor::class, QuotedProcessor::class, ArrayProcessor::class // Votre processeur personnalisé ]; (new DotEnv(__DIR__ . '/.env', $processors))->load();