بۆچی پێویستمان بە Environment Variables هەیە؟

لە پەرەپێدانی مۆدێرنی PHP-دا، زۆر گرنگە کە زانیارییە هەستیارەکان (وەک username و password-ی داتابەیس) لەناو کۆدی سەرچاوە (Source Code) ڕاستەوخۆ نەنووسین. ئەگەر کۆدەکەت لەسەر سەکۆیەکی وەک GitHub دابنێیت، هەموو کەسێک دەتوانێت زانیارییە نهێنییەکانت ببینێت. بۆ چارەسەرکردنی ئەم کێشەیە، ئێمە Environment Variables بەکاردەهێنین.

Environment Variables بریتییە لە کۆمەڵێک زانیاری کە لە دەرەوەی کۆدی سەرەکی پرۆژە هەڵدەگیرێن و لە کاتی کارکردنی بەرنامەکەدا دەخوێنرێنەوە. ئەمە ڕێگەیەک دەدات کە پرۆژەکەت لە ژینگەی Local و Production بە جیاواز کار بکات.

دروستکردنی فایلی .env

یەکەم هەنگاو دروستکردنی فایلێکە بە ناوی .env لە ڕەگی (Root) پرۆژەکەتدا. لەم فایلەدا زانیارییەکان بە شێوازی KEY=VALUE دەنووسرێن.

DB_HOST=localhost
DB_USER=root
DB_PASS=secret123

لە دوای نووسینی ئەم فایلە، دەبێت دڵنیابیت کە ئەم فایلە هەرگیز لەناو Git-دا بەرز ناکرێتەوە. بۆ ئەمەش دەبێت فایلی .gitignore بەکاربهێنیت.

بەکارهێنانی کتێبخانەی phpdotenv

PHP بە شێوەی سروشتی ناتوانێت فایلەکانی .env بخوێنێتەوە، بۆیە پێویستمان بە کتێبخانەی vlucas/phpdotenv هەیە کە لە ڕێگەی Composer-ەوە دایدەبەزێنین.

composer require vlucas/phpdotenv

ئەم کتێبخانەیە ڕێگەت پێ دەدات زانیارییەکان لەناو فایلی .env-ەوە بهێنیتە ناو گۆڕاوە ژینگەییەکانی سیستەم ($_ENV یان getenv()).

خوێندنەوەی زانیارییەکان لەناو کۆدی PHP

دوای دامەزراندنی کتێبخانەکە، دەتوانیت بەم شێوەیە لە فایلە سەرەکییەکەتدا (وەک index.php) بەکاری بهێنیت:

<?php
require 'vendor/autoload.php';

$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->load();

$dbUser = $_ENV['DB_USER'];
echo "Database User is: " . $dbUser;

لێرەدا ئێمە سەرەتا autoload-مان بانگ کردووە، پاشان فایلی .env-مان بار کردووە. ئەنجامەکەی بە ئاسانی زانیارییەکەی ناو فایلەکەت پێ دەدات.

تێبینی ئەمنی (Security Warning)

ئاگاداربە: هەرگیز فایلی .env لەناو کۆدی سەرچاوە (Source Control) وەک Git مەهێڵە. هەمیشە فایلی .env لەناو .gitignore زیاد بکە. بۆ ئەوەی هاوکارانت بزانن چ گۆڕاوێک پێویستە، فایلی .env.example دروست بکە کە تەنها ناوی کلیلەکان لەخۆ دەگرێت بەبێ بەها نهێنییەکان.

هەڵە باوەکان

یەکێک لە باوترین هەڵەکان ئەوەیە کە فایلی .env لە شوێنی هەڵە دادەنرێت. دڵنیابە کە فایلەکە لە ڕەگی سەرەکی پرۆژەکەتە و ناوی فایلەکە بە وردی .env-ە (بە خاڵێک لە سەرەتایدا). هەروەها دڵنیابە کە کتێبخانەی phpdotenv بە دروستی لە ڕێگەی Composer-ەوە دامەزراوە.

ئەنجامدانی ڕاهێنان

ئێستا کاتی ئەوەیە خۆت تاقی بکەیتەوە:

  • پرۆژەیەکی نوێ دروست بکە و Composer تێیدا دابمەزرێنە.
  • کتێبخانەی vlucas/phpdotenv دابەزێنە.
  • فایلێکی .env دروست بکە و کلیلێک بە ناوی APP_NAME تێیدا دابنێ.
  • بە بەکارهێنانی PHP، ئەو ناوە لەناو فایلەکە بخوێنەرەوە و لەسەر شاشە چاپت کرد.