php dotenv

PHP-DotEnv

PHP-DotEnv es una biblioteca PHP liviana diseñada para simplificar la administración de variables de entorno en sus aplicaciones PHP. Proporciona una solución elegante para cargar valores de configuración desde un archivo .env en las variables de entorno accesibles a través de getenv() , $_ENV y $_SERVER . Esta documentación tiene como objetivo guiarlo a través de la instalación, el uso y las características de PHP-DotEnv.

Instalación

Para instalar PHP-DotEnv, puede utilizar Composer, el administrador de dependencias de PHP.

Compositor Requiere

composer require phpdevcommunity/php-dotenv

Requisitos

• PHP versión 7.4 o superior

Uso

1. Definir variables de entorno

Antes de usar PHP-DotEnv, necesita definir sus variables de entorno en un archivo .env . Este archivo debe colocarse en el directorio raíz de su proyecto. Cada línea del archivo debe seguir el formato 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. Cargue las variables

Después de definir sus variables de entorno, puede cargarlas en su aplicación PHP usando PHP-DotEnv.

 <?php
use PhpDevCommunity  DotEnv ;

$ absolutePathToEnvFile = __DIR__ . ' /.env ' ;

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

3. Acceder a las variables de entorno

Una vez cargado, puede acceder a las variables de entorno utilizando la función getenv() de PHP.

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

Conversión automática de tipos

PHP-DotEnv proporciona conversión automática de tipos para ciertos tipos de valores:

• Booleanos: Procesados ​​como true o false .
• Cadenas entre comillas: se eliminan las comillas circundantes.
• Valores nulos: convertidos a null .
• Valores numéricos: convertidos a números enteros o flotantes.

Procesadores

PHP-DotEnv le permite definir procesadores personalizados para manejar tipos específicos de valores en su archivo .env . Estos procesadores le permiten controlar cómo se analizan y convierten los valores.

Procesador booleano

BooleanProcessor convierte los valores booleanos especificados en el archivo .env a tipos booleanos PHP ( true o false ).

 MODULE_ENABLED = true

Procesador cotizado

QuotedProcessor elimina las comillas circundantes de las cadenas entre comillas en el archivo .env .

 DATABASE_USER = " root "

Procesador nulo

NullProcessor convierte la cadena "nula" al valor null de PHP.

 NULL_VALUE = null

NúmeroProcesador

NumberProcessor convierte valores numéricos en números enteros o flotantes.

 NUMBER_LITERAL = 0 

Conclusión

PHP-DotEnv ofrece una solución sencilla y eficiente para gestionar variables de entorno en aplicaciones PHP. Al proporcionar conversión de tipos automática y procesadores personalizables, simplifica el proceso de carga y manejo de valores de configuración desde archivos .env . Ya sea que esté trabajando en un proyecto pequeño o en una aplicación a gran escala, PHP-DotEnv puede ayudarlo a optimizar su proceso de desarrollo y garantizar una gestión de configuración fluida. Explore sus características, intégrelo en sus proyectos y experimente la conveniencia que brinda a su flujo de trabajo de desarrollo PHP.