php dotenv

PHP-DotEnv

PHP-DotEnv 是一个轻量级 PHP 库，旨在简化 PHP 应用程序中环境变量的管理。它提供了一个优雅的解决方案，用于将配置值从.env文件加载到可通过getenv() 、 $_ENV和$_SERVER访问的环境变量中。本文档旨在指导您完成 PHP-DotEnv 的安装、使用和功能。

安装

要安装 PHP-DotEnv，您可以使用 Composer，PHP 的依赖项管理器。

作曲家要求

composer require phpdevcommunity/php-dotenv

要求

• PHP 版本 7.4 或更高版本

用法

1.定义环境变量

在使用 PHP-DotEnv 之前，您需要在.env文件中定义环境变量。该文件应放置在项目的根目录中。文件中的每一行都应遵循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. 加载变量

定义环境变量后，您可以使用 PHP-DotEnv 将它们加载到 PHP 应用程序中。

 <?php
use PhpDevCommunity  DotEnv ;

$ absolutePathToEnvFile = __DIR__ . ' /.env ' ;

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

3. 访问环境变量

加载后，您可以使用 PHP 的getenv()函数访问环境变量。

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

自动类型转换

PHP-DotEnv 为某些类型的值提供自动类型转换：

• 布尔值：处理为true或false 。
• 带引号的字符串：周围的引号被删除。
• Null 值：转换为null 。
• 数值：转换为整数或浮点数。

处理器

PHP-DotEnv 允许您定义自定义处理器来处理.env文件中特定类型的值。这些处理器使您能够控制值的解析和转换方式。

布尔处理器

BooleanProcessor将.env文件中指定的布尔值转换为 PHP 布尔类型（ true或false ）。

 MODULE_ENABLED = true

引用处理器

QuotedProcessor从.env文件中的带引号的字符串中删除周围的引号。

 DATABASE_USER = " root "

空处理器

NullProcessor将字符串“null”转换为 PHP null值。

 NULL_VALUE = null

数字处理器

NumberProcessor将数值转换为整数或浮点数。

 NUMBER_LITERAL = 0 

结论

PHP-DotEnv 为管理 PHP 应用程序中的环境变量提供了简单而高效的解决方案。通过提供自动类型转换和可定制的处理器，它简化了从.env文件加载和处理配置值的过程。无论您正在开发小型项目还是大型应用程序，PHP-DotEnv 都可以帮助简化您的开发流程并确保顺利的配置管理。探索它的功能，将其集成到您的项目中，体验它为您的 PHP 开发工作流程带来的便利。