PHP-DotEnv ist eine schlanke PHP-Bibliothek, die die Verwaltung von Umgebungsvariablen in Ihren PHP-Anwendungen vereinfacht. Es bietet eine elegante Lösung zum Laden von Konfigurationswerten aus einer .env
Datei in die Umgebungsvariablen, auf die über getenv()
, $_ENV
und $_SERVER
zugegriffen werden kann. Diese Dokumentation soll Sie durch die Installation, Verwendung und Funktionen von PHP-DotEnv führen.
Um PHP-DotEnv zu installieren, können Sie Composer verwenden, den Abhängigkeitsmanager für PHP.
composer require phpdevcommunity/php-dotenv
Bevor Sie PHP-DotEnv verwenden, müssen Sie Ihre Umgebungsvariablen in einer .env
Datei definieren. Diese Datei sollte im Stammverzeichnis Ihres Projekts abgelegt werden. Jede Zeile in der Datei sollte dem Format KEY=VALUE
folgen.
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
Nachdem Sie Ihre Umgebungsvariablen definiert haben, können Sie diese mit PHP-DotEnv in Ihre PHP-Anwendung laden.
<?php
use PhpDevCommunity DotEnv ;
$ absolutePathToEnvFile = __DIR__ . ' /.env ' ;
( new DotEnv ( $ absolutePathToEnvFile ))-> load ();
Nach dem Laden können Sie mit der Funktion getenv()
von PHP auf die Umgebungsvariablen zugreifen.
/**
* Retrieve the value of DATABASE_DNS
*/
var_dump ( getenv ( ' DATABASE_DNS ' ));
PHP-DotEnv bietet eine automatische Typkonvertierung für bestimmte Wertetypen:
true
oder false
verarbeitet.null
konvertiert. Mit PHP-DotEnv können Sie benutzerdefinierte Prozessoren definieren, um bestimmte Arten von Werten in Ihrer .env
Datei zu verarbeiten. Mit diesen Prozessoren können Sie steuern, wie Werte analysiert und konvertiert werden.
Der BooleanProcessor
konvertiert in der .env
Datei angegebene boolesche Werte in boolesche PHP-Typen ( true
oder false
).
MODULE_ENABLED = true
Der QuotedProcessor
entfernt umgebende Anführungszeichen aus in Anführungszeichen gesetzten Zeichenfolgen in der .env
Datei.
DATABASE_USER = " root "
Der NullProcessor
konvertiert die Zeichenfolge „null“ in den PHP- null
.
NULL_VALUE = null
Der NumberProcessor
wandelt numerische Werte in Ganzzahlen oder Gleitkommazahlen um.
NUMBER_LITERAL = 0
PHP-DotEnv bietet eine unkomplizierte und effiziente Lösung zur Verwaltung von Umgebungsvariablen in PHP-Anwendungen. Durch die Bereitstellung automatischer Typkonvertierung und anpassbarer Prozessoren vereinfacht es den Prozess des Ladens und Bearbeitens von Konfigurationswerten aus .env
Dateien. Unabhängig davon, ob Sie an einem kleinen Projekt oder einer umfangreichen Anwendung arbeiten, kann PHP-DotEnv Ihnen dabei helfen, Ihren Entwicklungsprozess zu rationalisieren und ein reibungsloses Konfigurationsmanagement sicherzustellen. Entdecken Sie seine Funktionen, integrieren Sie es in Ihre Projekte und erleben Sie den Komfort, den es für Ihren PHP-Entwicklungsworkflow bietet.