• 1.7.1
  • کامل شده
  • منقضی شده
این داکیومنت از طرف توسعه‌دهنده ساپورت نمی‌شود، جدیدترین ورژن داکیومنت بزودی ترجمه خواهد شد.

رابط خط فرمان کامپوزر مجموعه دستورهایی است که برای ایجاد پروژه، نصب و به‌روزرسانی وابستگی‌ها، بررسی وضعیت بسته‌ها، ساخت Autoloader و مدیریت تنظیمات استفاده می‌شوند. دستورها در این صفحه مطابق رفتار Composer 1.7.1 توضیح داده شده‌اند. برای دیدن فهرست فرمان‌ها از composer list و برای راهنمای یک فرمان از composer help install استفاده کنید.

گزینه‌های عمومی

گزینه‌های عمومی را می‌توان همراه بیشتر فرمان‌ها استفاده کرد. -h یا --help راهنما را نشان می‌دهد، -V نسخه را چاپ می‌کند، -v جزئیات بیشتری نمایش می‌دهد، -q خروجی را محدود می‌کند، -n پرسش تعاملی را غیرفعال می‌کند و -d مسیر کاری را تغییر می‌دهد. کد خروج صفر به معنی موفقیت است، کد ۱ خطای عمومی و کد ۲ خطای حل وابستگی‌ها را نشان می‌دهد.

ایجاد و نصب وابستگی‌ها

فرمان init فایل composer.json را با پرسش‌های تعاملی ایجاد می‌کند. install وابستگی‌ها را طبق فایل Lock نصب می‌کند. اگر composer.lock وجود داشته باشد، نسخه‌های دقیق همان فایل نصب می‌شوند. اگر وجود نداشته باشد، کامپوزر وابستگی‌ها را حل می‌کند و فایل Lock می‌سازد.

composer init
composer install
composer install --no-dev
composer install --prefer-dist --no-interaction

به‌روزرسانی و مدیریت بسته‌ها

فرمان update محدودیت‌های نسخه را دوباره حل می‌کند و Lock را به‌روزرسانی می‌کند. برای جلوگیری از تغییر همه وابستگی‌ها، نام بسته را مشخص کنید. require بسته را به require اضافه و نصب می‌کند، remove آن را حذف می‌کند و show اطلاعات بسته‌ها را نمایش می‌دهد.

composer update vendor/package
composer require monolog/monolog:^1.0
composer remove monolog/monolog
composer show --installed

Autoload و اسکریپت‌ها

پس از تغییر قواعد Autoload در composer.json، فرمان dump-autoload فایل‌های Autoloader را دوباره می‌سازد. در محیط Production معمولاً گزینه بهینه‌سازی مفید است. فرمان run-script اسکریپت تعریف‌شده را اجرا می‌کند و exec اجرای یک برنامه را با محیط وابستگی‌های پروژه ممکن می‌سازد.

composer dump-autoload -o
composer run-script test
composer run-script post-install-cmd

بررسی، عیب‌یابی و نگهداری

validate ساختار فایل‌های Composer و سازگاری Lock با Manifest را بررسی می‌کند. diagnose مشکلات رایج محیط، شبکه و تنظیمات را گزارش می‌دهد. outdated بسته‌های دارای نسخه جدیدتر را نشان می‌دهد، why توضیح می‌دهد چرا بسته‌ای نصب شده و why-not علت ناسازگاری یک نسخه را مشخص می‌کند. clear-cache کش محلی را پاک می‌کند و self-update خود Composer را به‌روزرسانی می‌کند.

composer validate
composer diagnose
composer outdated
composer why symfony/console
composer why-not php 7.2
composer clear-cache

ساخت پروژه و مدیریت مخزن

create-project یک پروژه آماده را از بسته مشخص‌شده نصب می‌کند. config تنظیمات محلی یا سراسری را تغییر می‌دهد. global فرمان را در محیط Composer سراسری اجرا می‌کند. licenses مجوز وابستگی‌های نصب‌شده را فهرست می‌کند و archive از یک بسته آرشیو می‌سازد.

composer create-project laravel/laravel app
composer config --list
composer global require phpunit/phpunit
composer licenses
composer archive

فرمان‌های مهم در یک نگاه

فرمانکاربرد
initساخت composer.json
installنصب طبق Lock
updateحل دوباره نسخه‌ها
requireافزودن وابستگی
removeحذف وابستگی
showنمایش اطلاعات بسته
searchجست‌وجوی بسته
outdatedنمایش نسخه‌های قدیمی
validateاعتبارسنجی فایل‌ها
dump-autoloadبازسازی Autoloader
run-scriptاجرای اسکریپت
create-projectساخت پروژه از بسته
configتغییر تنظیمات
globalمدیریت بسته‌های سراسری
licensesنمایش مجوزها
clear-cacheپاک کردن کش
diagnoseبررسی سلامت محیط
self-updateبه‌روزرسانی Composer
archiveساخت آرشیو
whyنمایش زنجیره وابستگی
why-notبررسی ناسازگاری نسخه

نکته مهم

گزینه‌هایی مانند --ignore-platform-reqs محدودیت نسخه PHP یا افزونه را نادیده می‌گیرند. استفاده از آن‌ها راه‌حل دائمی نیست و ممکن است بسته‌ای نصب شود که در محیط اجرا کار نکند.

مطالعه مرتبط

برای ادامه مطالعه، تزریق وابستگی، Autoload، ورژنینگ را ببینید.