php dotenv

PHP-DotEnv

PHP-DotEnv é uma biblioteca PHP leve projetada para simplificar o gerenciamento de variáveis ​​de ambiente em seus aplicativos PHP. Ele fornece uma solução elegante para carregar valores de configuração de um arquivo .env nas variáveis ​​de ambiente acessíveis via getenv() , $_ENV e $_SERVER . Esta documentação tem como objetivo guiá-lo através da instalação, uso e recursos do PHP-DotEnv.

Instalação

Para instalar o PHP-DotEnv, você pode usar o Composer, o gerenciador de dependências do PHP.

Exigência do compositor

composer require phpdevcommunity/php-dotenv

Requisitos

• PHP versão 7.4 ou superior

Uso

1. Defina variáveis ​​de ambiente

Antes de usar PHP-DotEnv, você precisa definir suas variáveis ​​de ambiente em um arquivo .env . Este arquivo deve ser colocado no diretório raiz do seu projeto. Cada linha do arquivo deve seguir o 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. Carregue as variáveis

Depois de definir suas variáveis ​​de ambiente, você pode carregá-las em seu aplicativo PHP usando PHP-DotEnv.

 <?php
use PhpDevCommunity  DotEnv ;

$ absolutePathToEnvFile = __DIR__ . ' /.env ' ;

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

3. Acesse variáveis ​​de ambiente

Uma vez carregado, você pode acessar as variáveis ​​de ambiente usando a função getenv() do PHP.

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

Conversão automática de tipo

PHP-DotEnv fornece conversão automática de tipo para certos tipos de valores:

• Booleanos: Processado como true ou false .
• Strings entre aspas: as aspas circundantes são removidas.
• Valores nulos: convertidos em null .
• Valores numéricos: convertidos em números inteiros ou flutuantes.

Processadores

PHP-DotEnv permite definir processadores personalizados para lidar com tipos específicos de valores em seu arquivo .env . Esses processadores permitem controlar como os valores são analisados ​​e convertidos.

Processador Booleano

O BooleanProcessor converte valores booleanos especificados no arquivo .env em tipos booleanos PHP ( true ou false ).

 MODULE_ENABLED = true

CitadoProcessador

O QuotedProcessor remove aspas circundantes das strings entre aspas no arquivo .env .

 DATABASE_USER = " root "

Processador Nulo

O NullProcessor converte a string "null" no valor null do PHP.

 NULL_VALUE = null

NúmeroProcessador

O NumberProcessor converte valores numéricos em inteiros ou flutuantes.

 NUMBER_LITERAL = 0 

Conclusão

PHP-DotEnv oferece uma solução simples e eficiente para gerenciar variáveis ​​de ambiente em aplicações PHP. Ao fornecer conversão automática de tipo e processadores personalizáveis, simplifica o processo de carregamento e manipulação de valores de configuração de arquivos .env . Esteja você trabalhando em um projeto pequeno ou em um aplicativo de grande escala, o PHP-DotEnv pode ajudar a agilizar seu processo de desenvolvimento e garantir um gerenciamento de configuração tranquilo. Explore seus recursos, integre-o aos seus projetos e experimente a conveniência que ele traz ao seu fluxo de trabalho de desenvolvimento PHP.