PHP-DotEnv

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.

---

English Documentation

Installation

Requires PHP 7.4 or higher.

Install via Composer:

composer require michel/dotenv

Basic Usage

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

   APP_ENV=devDATABASE_URL="mysql:host=localhost;dbname=test"DEBUG=trueCACHE_TTL=3600API_KEY=null# This is a comment

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

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

Features

1. Automatic Type Conversion (Default Processors)

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.

2. Comments

Lines starting with # are treated as comments and ignored.

3. Trimming

Keys and values are automatically trimmed of whitespace.

Advanced Usage: Custom Processors

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

Creating a Custom Processor

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

namespaceApp\Processor;
useMichel\Env\Processor\AbstractProcessor;
class ArrayProcessor extends AbstractProcessor
{
publicfunctioncanBeProcessed(): bool
{
// Process only if value contains a commareturnstrpos($this->value, ',') !== false;
}
publicfunctionexecute()
{
returnarray_map('trim', explode(',', $this->value));
}
}

Registering Custom Processors

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.

useMichel\Env\DotEnv;
useMichel\Env\Processor\BooleanProcessor;
useMichel\Env\Processor\NullProcessor;
useMichel\Env\Processor\NumberProcessor;
useMichel\Env\Processor\QuotedProcessor;
useApp\Processor\ArrayProcessor;
$processors = [
BooleanProcessor::class,
NullProcessor::class,
NumberProcessor::class,
QuotedProcessor::class,
ArrayProcessor::class // Your custom processor
];
(newDotEnv(__DIR__ . '/.env', $processors))->load();

---

🇫🇷 Documentation Française

Introduction

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.

Installation

Nécessite PHP 7.4 ou supérieur.

Installez via Composer :

composer require michel/dotenv

Utilisation de Base

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

   APP_ENV=devDATABASE_URL="mysql:host=localhost;dbname=test"DEBUG=trueCACHE_TTL=3600API_KEY=null# Ceci est un commentaire

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

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

Fonctionnalités

1. Conversion Automatique des Types (Processeurs par défaut)

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.

2. Commentaires

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

3. Nettoyage (Trimming)

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

Utilisation Avancée : Processeurs Personnalisés

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

Créer un Processeur Personnalisé

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

namespaceApp\Processor;
useMichel\Env\Processor\AbstractProcessor;
class ArrayProcessor extends AbstractProcessor
{
publicfunctioncanBeProcessed(): bool
{
// Traiter uniquement si la valeur contient une virgulereturnstrpos($this->value, ',') !== false;
}
publicfunctionexecute()
{
returnarray_map('trim', explode(',', $this->value));
}
}

Enregistrer les Processeurs Personnalisés

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.

useMichel\Env\DotEnv;
useMichel\Env\Processor\BooleanProcessor;
useMichel\Env\Processor\NullProcessor;
useMichel\Env\Processor\NumberProcessor;
useMichel\Env\Processor\QuotedProcessor;
useApp\Processor\ArrayProcessor;
$processors = [
BooleanProcessor::class,
NullProcessor::class,
NumberProcessor::class,
QuotedProcessor::class,
ArrayProcessor::class // Votre processeur personnalisé
];
(newDotEnv(__DIR__ . '/.env', $processors))->load();