Composer چییە؟
کۆمپۆزەر (Composer) ئامرازێکی بەڕێوەبردنی Dependency-یە بۆ زمانی PHP. کاتێک پڕۆژەیەکی گەورە دروست دەکەیت، پێویستت بە بەکارهێنانی کتێبخانە (Library) و پارچە کۆدی دەرەکی دەبێت. لەبری ئەوەی هەموو ئەو فایلانە بە دەستی دابگریت، Composer ئەم کارە بۆت دەکات و پەیوەندی نێوان ئەو کتێبخانانەش ڕێکدەخات.
هەنگاوی یەکەم: دامەزراندن
بۆ ئەوەی دەست بە کار بکەیت، پێویستە Composer لەسەر کۆمپیوتەرەکەت دابمەزرێنیت. دوای دامەزراندن، دەتوانیت لە ڕێگەی Terminal یان Command Prompt دڵنیابیتەوە لەوەی کاردەکات بە نووسینی ئەم فەرمانە:
composer --version
ئەگەر وەشانی Composer-ەکەت نیشاندا، واتە هەموو شتێک ئامادەیە بۆ دەستپێکردن.
دروستکردنی فایلێکی composer.json
هەموو پڕۆژەیەکی Composer پێویستی بە فایلێک هەیە بە ناوی composer.json. ئەم فایلە وەک نەخشەی پڕۆژەکەت وایە کە ناوی ئەو کتێبخانانەی تێدا دەنووسرێت کە پێویستت پێیانە. دەتوانیت بە فەرمانی خوارەوە دەست پێبکەیت:
composer init
ئەم فەرمانە چەند پرسیارێکت لێدەکات و فایلێکی بنەڕەتی بۆت دروست دەکات. ئەنجامی ئەم کارە فایلێکی ئاوایە:
{
"name": "my-project/app",
"require": {
"monolog/monolog": "^3.0"
}
}
لە نموونەکەدا، ئێمە کتێبخانەی Monolog-مان بۆ بەکارهێنانی لۆگ (Logging) زیاد کردووە. هەڵەی باو کە فێرخوازان دەیکەن ئەوەیە کە ناوی کتێبخانەکە بە هەڵە دەنووسن یان وەشانی گونجاو دیاری ناکەن.
دامەزراندنی کتێبخانەکان
دوای ئەوەی ناوی کتێبخانەکەت لە فایلەکەدا نووسی، کاتی ئەوەیە دایانمەزرێنیت. تەنها پێویستە ئەم فەرمانە لە Terminal بنووسیت:
composer install
ئەم فەرمانە دەبێتە هۆی دروستبوونی بوخچەیەک بە ناوی vendor کە هەموو فایلەکانی کتێبخانەکەی تێدایە. هەروەها فایلێکی گرنگ بە ناوی composer.lock دروست دەکات کە دڵنیایی دەدات هەموو کەسێک لە تیمەکەت هەمان وەشانی کتێبخانەکەی بەکاردەهێنن.
بەکارهێنانی Autoload
یەکێک لە باشترین تایبەتمەندییەکانی Composer ئەوەیە کە بە شێوەیەکی ئۆتۆماتیکی فایلەکانت بۆ بانگدەکات (Autoloading). تەنها پێویستە ئەم دێڕە لە سەرەتای فایلە PHP-کەتدا دابنێیت:
require 'vendor/autoload.php';
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
$log = new Logger('name');
$log->pushHandler(new StreamHandler('app.log', Logger::WARNING));
$log->warning('ئەمە پەیامێکی هۆشداریدانە');
بە بەکارهێنانی ئەم ڕێگەیە، ئیتر پێویست ناکات بەردەوام require یان include بۆ فایلەکان بکەیت.
ئەنجامدانی ڕاهێنان
بۆ ئەوەی ئەم وانەیە بە تەواوی فێربیت، ئەم ڕاهێنانە ئەنجام بدە:
- ١. پڕۆژەیەکی نوێ دروست بکە.
- ٢. کتێبخانەی 'fakerphp/faker' لە ڕێگەی composer require فەرمانەکەوە دابمەزرێنە.
- ٣. بەکارهێنانی کتێبخانەکە تاقیبکەرەوە بۆ دروستکردنی ناوی ساختە (Fake Name) لە فایلێکی PHP-دا.