- دوشنبه 20 مهر 1405 ساعت 12:00
- 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 --installedAutoload و اسکریپتها
پس از تغییر قواعد 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، ورژنینگ را ببینید.