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-приложение с помощью PHP-DotEnv.

 <?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 .
• Числовые значения: преобразуются в целые числа или числа с плавающей запятой.

Процессоры

PHP-DotEnv позволяет вам определять собственные процессоры для обработки определенных типов значений в вашем файле .env . Эти процессоры позволяют вам контролировать, как значения анализируются и преобразуются.

ЛогическийПроцессор

BooleanProcessor преобразует логические значения, указанные в файле .env , в логические типы PHP ( true или false ).

 MODULE_ENABLED = true

ЦитируемыйПроцессор

QuotedProcessor удаляет окружающие кавычки из строк в кавычках в файле .env .

 DATABASE_USER = " root "

Нулевой процессор

NullProcessor преобразует строку «null» в null значение PHP.

 NULL_VALUE = null

НомерПроцессор

NumberProcessor преобразует числовые значения в целые числа или числа с плавающей запятой.

 NUMBER_LITERAL = 0 

Заключение

PHP-DotEnv предлагает простое и эффективное решение для управления переменными среды в приложениях PHP. Обеспечивая автоматическое преобразование типов и настраиваемые процессоры, он упрощает процесс загрузки и обработки значений конфигурации из файлов .env . Независимо от того, работаете ли вы над небольшим проектом или крупномасштабным приложением, PHP-DotEnv поможет оптимизировать процесс разработки и обеспечить плавное управление конфигурацией. Изучите его возможности, интегрируйте его в свои проекты и оцените удобство, которое он приносит в рабочий процесс разработки PHP.