آخرین بازبینی: ۱۴۰۴/۰۷/۱۴

آموزش نصب کامپوزر ( Composer )

کامپوزر یک ابزار مدیریت وابستگی برای PHP است. این ابزار به شما کمک می‌کند تا کتابخانه‌هایی (بسته‌هایی) را که پروژه شما به آنها نیاز دارد را تعیین، نصب و مدیریت کنید. به جای دانلود تک به تک، الزامات پروژه خود را در فایلی به نام composer.json فهرست می‌کنید. سپس کامپوزر به طور خودکار نسخه‌های صحیح آن کتابخانه‌ها را دانلود کرده و بارگذاری Autoload یا بارگزاری خودکار را تنظیم می‌کند تا بتوانید بلافاصله از آن‌ها در پروژه‌ی خودتان استفاده کنید.

همچنین به‌روزرسانی‌ها را مدیریت کرده و سازگاری بین بسته‌ها را تضمین می‌کند. کامپوزر که به طور گسترده در جامعه PHP استفاده می‌شود، راه‌اندازی پروژه را ساده می‌کند و استفاده مجدد از کد را در عمل امکان‌پذیر می‌کند. اگر در حال طراحی و برنامه‌نویس یک سایت یا یک برنامه PHP هستید، کامپوزر در زمان شما صرفه‌جویی می‌کند و وابستگی‌های پروژه‌ی شما را با دقت مدیریت می‌کند.

نصب کامپوزر

در این نوشته مراحل لازم برای نصب نرم‌افزار کامپوزر را مرور خواهیم نمود.

۱ - دانلود Composer

برای دانلود به وبسایت رسمی این برنامه به نشانی getcomposer.org مراجعه کنید.
برای دانلود آخرین نگارش این برنامه برای سیستم عامل ویندوز اینجا کلیک کنید.

۲- شروع نصب Composer

فایل دانلود شده( Composer-Setup.exe ) را اجرا کنید و مراحل را مانند تصاویر زیر دنبال کنید.

در این مرحله می‌بایست نشانی فایل اجرایی php را برای نصب Composer مشخص نمایید. اگر نرم‌افزار نصب نتواند به صورت خودکار این فایل را شناسایی کند، لازم است تا با زدن دکمه‌ی Browse این مرحله را به صورت دستی پیش ببرید.

کامپوزر برای دریافت بسته‌ها نیازمند اتصال به اینترنت است، اگر برای اتصال به اینترنت، استفاده از پراکسی الزامی است، این بخش را با اطلاعات لازم پر کنید.

فعال کردن OpenSSL

با توجه به اینکه اتصال Composer به اینترنت از طریق پروتکل امن https به انجام می‌رسد، لازم است پیش از شروع به نصب، فایل php.ini واقع شده در کنار فایل اجرایی php.exe را ویرایش کنید و بررسی کنید که در ابتدای خط extension=php_openssl.dll نقطه ویرگول قرار نگرفته باشد. اگر علامت نقطه‌ویرگول در ابتدای این خط موجود است، آن را حذف کنید و فایل را ذخیره نمایید.

در این مرحله کامپوزر به شما اطلاع می‌دهد که تغییرات لازم در سیستم شما به انجام رسیده است و برای فعال‌سازی کامل آن می‌بایست پنجره‌های Command Prompt موجود را ببندید و مجددا باز نمایید.

اکنون با زدن کلید Finish نصب کامپوزر را به پایان برسانید.

خطای GitHub OAuth token در هنگام استفاده از Composer

یکی از خطاها که ممکن است در هنگام استفاده از Composer با آن مواجه شوید خطای زیر است:

Could not fetch https://api.github.com/repos/..., please review your configured GitHub OAuth token or enter a new one to access private repos.

این خطا به دلیل خصوصی بودن برخی از از مخزن‌های کد مورد استفاد‌ه در پروژه است و برای اینکه بتوانید این‌گونه بسته‌ها را دانلود کنید، Composer از شما توکن OAuth را درخواست می‌کند.

برای ساخت توکن ابتدا باید در Github ثبت نام کرده باشید و ایمیل شما تایید شده باشد. سپس مراحل زیر را دنبال کنید و یک توکن ایجاد نمایید:

در گوشه‌ی سمت راست صفحه روی تصویر پروفایل‌تان کلیک کنید و گزینه‌ی Settings را انتخاب کنید.
در صفحه‌ی تنظیمات در نوار کناری روی Developer settings کلیک کنید.
در نوار کناری روی گزینه‌ی Personal access tokens کلیک کنید.
در صفحه‌ی بعدی روی دکمه‌ی Generate new token کلیک کنید.
نام دلخواه برای توکن وارد کنید. مثلا Composer
در فهرست دسترسی‌های موجود فقط گزینه‌ی «read:packages» را فعال کنید.
روی دکمه‌ی Generate token کلیک کنید.

اکنون توکن شما ایجاد می‌شود و با استفاده از آن می‌توانید بسته‌های موجود در گیت‌هاب را با استفاده از Composer دانلود کنید. این توکن فقط یک بار به شما نمایش داده می‌شود و اگر آن را گم کنید، امکان بازیابی آن وجود ندارد و مجددا همین مراحل را باید تکرار کنید.

توکن ایجاد شده را کپی کنید و با کلیک راست آن را در اختیار Composer قرار دهید تا به صورت خودکار در فایل Composer\auth.json جاگذاری شود.

ساخت فایل composer.json

این فایل می‌تواند با خط فرمان توسط Composer ایجاد شود. یک فایل ساده برای اولین پروژه‌ی شما ممکن است به شکل زیر باشد:

{
    "name": "roka/demo",
    "description": "A sample PHP project",
    "require": {
        "monolog/monolog": "^2.0"
    }
}

{

"name": "roka/demo",

"description": "A sample PHP project",

"require": {

"monolog/monolog": "^2.0"

}

این فایل اطلاعات اولیه‌ای در مورد پروژه شما به Composer می‌دهد. نام، یک شناسه منحصر به فرد است (معمولاً در قالب vendor/project). توضیحات به طور خلاصه توضیح می‌دهد که پروژه چه کاری انجام می‌دهد.

بخش require، کتابخانه‌های خارجی مورد نیاز پروژه شما را فهرست می‌کند. در این مورد، بسته Monolog (یک ابزار ثبت لاگ محبوب) با نسخه ۲.۰ یا بالاتر، اما نه نسخه ۳.

وقتی composer install را اجرا می‌کنید، Composer این فایل را می‌خواند و به طور خودکار Monolog و تمام وابستگی‌های آن را در یک پوشه vendor دانلود می‌کند، که برای استفاده در پروژه‌ی شما آماده است.

استفاده از کامپوزر

برای استفاده از کامپوزر، می‌توانید به محیط Command Prompt مراجعه کنید و پس از یافتن شاخه‌ای که فایل composer.json در آن قرار دارد، دستور composer update یا composer install را اجرا نمایید.

همچنین برای به‌روزرسانی کامپوزر، از خط فرمان، دستور composer self-update را اجرا کنید.