php dotenv

PHP-DotEnv

PHP-DotEnv est une bibliothèque PHP légère conçue pour simplifier la gestion des variables d'environnement dans vos applications PHP. Il fournit une solution élégante pour charger les valeurs de configuration d'un fichier .env dans les variables d'environnement accessibles via getenv() , $_ENV et $_SERVER . Cette documentation vise à vous guider dans l'installation, l'utilisation et les fonctionnalités de PHP-DotEnv.

Installation

Pour installer PHP-DotEnv, vous pouvez utiliser Composer, le gestionnaire de dépendances pour PHP.

Compositeur requis

composer require phpdevcommunity/php-dotenv

Exigences

• PHP version 7.4 ou supérieure

Usage

1. Définir les variables d'environnement

Avant d'utiliser PHP-DotEnv, vous devez définir vos variables d'environnement dans un fichier .env . Ce fichier doit être placé dans le répertoire racine de votre projet. Chaque ligne du fichier doit suivre le format KEY=VALUE .

 APP_ENV = dev
DATABASE_DNS = mysql:host=localhost;dbname=test;
DATABASE_USER = " root "
DATABASE_PASSWORD = root
MODULE_ENABLED = true
NUMBER_LITERAL = 0
NULL_VALUE = null

2. Chargez les variables

Après avoir défini vos variables d'environnement, vous pouvez les charger dans votre application PHP à l'aide de PHP-DotEnv.

 <?php
use PhpDevCommunity  DotEnv ;

$ absolutePathToEnvFile = __DIR__ . ' /.env ' ;

( new DotEnv ( $ absolutePathToEnvFile ))-> load ();

3. Accéder aux variables d'environnement

Une fois chargé, vous pouvez accéder aux variables d'environnement à l'aide de la fonction getenv() de PHP.

 /**
 * Retrieve the value of DATABASE_DNS
 */
var_dump ( getenv ( ' DATABASE_DNS ' ));

Conversion automatique des types

PHP-DotEnv fournit une conversion de type automatique pour certains types de valeurs :

• Booléens : traités comme true ou false .
• Chaînes entre guillemets : les guillemets environnants sont supprimés.
• Valeurs nulles : converties en null .
• Valeurs numériques : converties en entiers ou en flottants.

Processeurs

PHP-DotEnv vous permet de définir des processeurs personnalisés pour gérer des types spécifiques de valeurs dans votre fichier .env . Ces processeurs vous permettent de contrôler la façon dont les valeurs sont analysées et converties.

Processeur booléen

Le BooleanProcessor convertit les valeurs booléennes spécifiées dans le fichier .env en types booléens PHP ( true ou false ).

 MODULE_ENABLED = true

Processeur cité

Le QuotedProcessor supprime les guillemets environnants des chaînes entre guillemets dans le fichier .env .

 DATABASE_USER = " root "

Processeur nul

Le NullProcessor convertit la chaîne « null » en valeur PHP null .

 NULL_VALUE = null

NuméroProcesseur

Le NumberProcessor convertit les valeurs numériques en entiers ou en flottants.

 NUMBER_LITERAL = 0 

Conclusion

PHP-DotEnv offre une solution simple et efficace pour gérer les variables d'environnement dans les applications PHP. En fournissant une conversion de type automatique et des processeurs personnalisables, il simplifie le processus de chargement et de gestion des valeurs de configuration à partir des fichiers .env . Que vous travailliez sur un petit projet ou une application à grande échelle, PHP-DotEnv peut vous aider à rationaliser votre processus de développement et à assurer une gestion fluide de la configuration. Explorez ses fonctionnalités, intégrez-le dans vos projets et découvrez la commodité qu'il apporte à votre flux de travail de développement PHP.