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. الوصول إلى متغيرات البيئة

بمجرد التحميل، يمكنك الوصول إلى متغيرات البيئة باستخدام وظيفة getenv() الخاصة بـ PHP.

 /**
 * 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 PHP.

 NULL_VALUE = null

معالج الرقم

يقوم NumberProcessor بتحويل القيم الرقمية إلى أعداد صحيحة أو أعداد عشرية.

 NUMBER_LITERAL = 0 

خاتمة

يقدم PHP-DotEnv حلاً مباشرًا وفعالاً لإدارة متغيرات البيئة في تطبيقات PHP. من خلال توفير تحويل تلقائي للنوع ومعالجات قابلة للتخصيص، فإنه يبسط عملية تحميل ومعالجة قيم التكوين من ملفات .env . سواء كنت تعمل على مشروع صغير أو تطبيق واسع النطاق، يمكن أن يساعدك PHP-DotEnv في تبسيط عملية التطوير الخاصة بك وضمان إدارة التكوين بشكل سلس. استكشف ميزاته، وادمجه في مشاريعك، واستمتع بتجربة الراحة التي يوفرها لسير عمل تطوير PHP الخاص بك.