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 開發工作流程帶來的便利。