راهنمای جامع نصب و استفاده از Composer در PHP (مطابق با استانداردهای روز)

امروزه توسعه وب بدون استفاده از کتابخانه‌های آماده و ابزارهای جانبی تقریباً غیرممکن یا بسیار زمان‌بر است. در دنیای PHP، ابزاری به نام Composer وجود دارد که وظیفه مدیریت این وابستگی‌ها (Dependencies) را بر عهده دارد. با استفاده از کامپوزر می‌توانید به راحتی هزاران پکیج کاربردی را به پروژه خود اضافه کنید.

کامپوزر (Composer) چیست؟

کامپوزر یک ابزار مدیریت وابستگی (Dependency Manager) برای زبان برنامه‌نویسی PHP است. بر خلاف پکیج‌منیجرهای سنتی، کامپوزر پکیج‌ها را به صورت سراسری نصب نمی‌کند؛ بلکه آن‌ها را در پوشه‌ای به نام vendor در داخل خود پروژه نصب می‌کند تا پروژه‌های مختلف تداخلی با یکدیگر نداشته باشند.

پیش‌نیازها

قبل از نصب Composer، باید مطمئن شوید که PHP روی سیستم شما نصب شده است. برای بررسی این موضوع، ترمینال یا Command Prompt را باز کرده و دستور زیر را تایپ کنید:

php -v

آموزش نصب Composer در ویندوز

آسان‌ترین راه برای نصب کامپوزر در سیستم‌عامل ویندوز، استفاده از نصب‌کننده رسمی آن است:

1. فایل نصب‌کننده Composer-Setup.exe را از سایت رسمی getcomposer.org دانلود کنید.
2. فایل دانلودی را اجرا کرده و مراحل را دنبال کنید.
3. در طول نصب، برنامه از شما مسیر فایل اجرای PHP (مانند C:\xampp\php\php.exe) را می‌خواهد؛ آن را به درستی معرفی کنید.
4. پس از اتمام نصب، یک بار Command Prompt را ببندید و دوباره باز کنید.

آموزش نصب Composer در لینوکس و مک (macOS)

برای نصب کامپوزر در محیط‌های Unix-based (مانند لینوکس و اوبونتو)، دستورات زیر را به ترتیب در ترمینال خود اجرا کنید:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"

برای اینکه بتوانید دستور composer را به صورت سراسری (Global) استفاده کنید، فایل اجرایی را به مسیر برنامه‌های سیستم منتقل کنید:

sudo mv composer.phar /usr/local/bin/composer

تست صحت نصب کامپوزر

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

composer --version

نحوه استفاده و مدیریت پکیج‌ها

۱. مقداردهی اولیه پروژه (Initialize)

برای ایجاد فایل پیکربندی کامپوزر در یک پروژه جدید، از دستور زیر استفاده کنید:

composer init

این دستور سوالاتی درباره پروژه از شما می‌پرسد و در نهایت فایل composer.json را ایجاد می‌کند.

۲. نصب یک پکیج جدید

برای نمونه، جهت نصب کتابخانه معروف Carbon (برای کار با تاریخ و زمان)، دستور زیر را در پوشه پروژه اجرا کنید:

composer require nesbot/carbon

این کار پکیج را در پوشه vendor دانلود کرده و اطلاعات آن را به فایل composer.json اضافه می‌کند.

۳. ساختار فایل composer.json

نمونه‌ای از یک فایل composer.json به شکل زیر است:

{
    "require": {
        "nesbot/carbon": "^2.0"
    }
}

استفاده از Autoload در PHP

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

require 'vendor/autoload.php';

use Carbon\Carbon;

echo "تاریخ امروز: " . Carbon::now()--->toDateTimeString();

بروزرسانی پکیج‌ها

برای بروزرسانی تمام کتابخانه‌های پروژه به آخرین نسخه‌های مجاز تعریف شده در composer.json، دستور زیر را اجرا کنید:

composer update

پیشنمایش