بۆچی پێویستمان بە Environment Variables هەیە؟
لە پەرەپێدانی مۆدێرنی PHP-دا، زۆر گرنگە کە زانیارییە هەستیارەکان (وەک username و password-ی داتابەیس) لەناو کۆدی سەرچاوە (Source Code) ڕاستەوخۆ نەنووسین. ئەگەر کۆدەکەت لەسەر سەکۆیەکی وەک GitHub دابنێیت، هەموو کەسێک دەتوانێت زانیارییە نهێنییەکانت ببینێت. بۆ چارەسەرکردنی ئەم کێشەیە، ئێمە Environment Variables بەکاردەهێنین.
دروستکردنی فایلی .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 لە شوێنی هەڵە دادەنرێت. دڵنیابە کە فایلەکە لە ڕەگی سەرەکی پرۆژەکەتە و ناوی فایلەکە بە وردی .env-ە (بە خاڵێک لە سەرەتایدا). هەروەها دڵنیابە کە کتێبخانەی phpdotenv بە دروستی لە ڕێگەی Composer-ەوە دامەزراوە.
ئەنجامدانی ڕاهێنان
ئێستا کاتی ئەوەیە خۆت تاقی بکەیتەوە:
- پرۆژەیەکی نوێ دروست بکە و Composer تێیدا دابمەزرێنە.
- کتێبخانەی
vlucas/phpdotenvدابەزێنە. - فایلێکی
.envدروست بکە و کلیلێک بە ناویAPP_NAMEتێیدا دابنێ. - بە بەکارهێنانی PHP، ئەو ناوە لەناو فایلەکە بخوێنەرەوە و لەسەر شاشە چاپت کرد.