Download the PHP package phpdevcommunity/php-dotenv without Composer
On this page you can find all versions of the php package phpdevcommunity/php-dotenv. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download phpdevcommunity/php-dotenv
More information about phpdevcommunity/php-dotenv
Files in phpdevcommunity/php-dotenv
Package php-dotenv
Short Description PHP-DotEnv is a lightweight PHP library designed to simplify the management of environment variables in your PHP applications.
License MIT
Informations about the package php-dotenv
⚠️ Abandoned package
This package is abandoned and no longer maintained.
The author suggests using michel/dotenv instead.
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:
Basic Usage
-
Create a
.envfile in your project root: - Load the variables in your PHP entry point (e.g.,
index.php):
Features
1. Automatic Type Conversion (Default Processors)
PHP-DotEnv automatically processes values using default processors:
- BooleanProcessor: Converts
trueandfalse(case-insensitive) to PHPbool. - NullProcessor: Converts
null(case-insensitive) to PHPnull. - NumberProcessor: Converts numeric strings to
intorfloat. - 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 PhpDevCommunity\Processor\AbstractProcessor.
Creating a Custom Processor
Example: A processor that converts comma-separated strings into arrays.
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.
🇫🇷 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 :
Utilisation de Base
-
Créez un fichier
.envà la racine de votre projet : - Chargez les variables dans votre point d'entrée PHP (ex:
index.php) :
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
trueetfalse(insensible à la casse) enboolPHP. - NullProcessor : Convertit
null(insensible à la casse) ennullPHP. - NumberProcessor : Convertit les chaînes numériques en
intoufloat. - 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 PhpDevCommunity\Processor\AbstractProcessor.
Créer un Processeur Personnalisé
Exemple : Un processeur qui convertit les chaînes séparées par des virgules en tableaux.
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.