- دوشنبه 20 مهر 1405 ساعت 22:00
- 1.7.1
- کامل شده
- منقضی شده
مخزن در Composer محلی است که اطلاعات بستهها و راه دریافت نسخههای آنها را نگه میدارد. هنگام اجرای install یا update، کامپوزر مخزنهای تعریفشده را بررسی میکند تا نسخه سازگار وابستگیهای پروژه را پیدا کند. مخزن پیشفرض Composer، پکیجیست است، اما میتوانید مخزن خصوصی یا محلی هم تعریف کنید.
Package، نسخه و منبع دریافت
هر Package با نام و نسخه شناخته میشود و اطلاعاتی درباره محل دریافت فایلها دارد. dist معمولاً آرشیو آماده انتشار است و برای نصب سریع مناسب است. source به مخزن کد مانند Git اشاره میکند و برای توسعه یا اعمال تغییر روی خود بسته کاربرد دارد. یک نسخه میتواند هر دو منبع را داشته باشد و Composer با توجه به تنظیمات و گزینههای فرمان یکی را انتخاب کند.
انواع مخزن
| نوع | کاربرد | سناریو |
|---|---|---|
composer | مخزن مبتنی بر metadata و packages.json | مخزن خصوصی سازمان |
vcs | دریافت مستقیم از Git، SVN، Mercurial یا Fossil | پکیج داخلی در GitLab |
path | بارگذاری بسته از مسیر محلی | Monorepo یا توسعه همزمان چند پکیج |
package | تعریف metadata یک بسته بهصورت Inline | کتابخانهای بدون پشتیبانی Composer |
artifact | خواندن ZIP یا TAR از پوشه محلی | انتشار بسته در شبکه داخلی |
تعریف مخزن سفارشی
مخزنها در بخش repositories فایل ریشه پروژه تعریف میشوند. ترتیب اهمیت دارد و Composer از بالا به پایین آنها را بررسی میکند. اگر نام بسته در یک مخزن پیدا شود، در حالت معمول جستوجوی مخزنهای بعدی برای همان بسته ادامه پیدا نمیکند.
{
"repositories": [
{"type": "vcs", "url": "https://git.example.org/acme/catalog"},
{"type": "path", "url": "../shared-package"},
{"type": "composer", "url": "https://packages.example.org"}
],
"require": {"acme/catalog": "dev-main"}
}VCS و شاخههای توسعه
برای مخزن VCS کافی است URL مخزن را معرفی کنید. Composer فایل composer.json بسته را در شاخهها و Tagها بررسی میکند. برای نصب شاخه توسعه، معمولاً از نامهایی مانند dev-main یا dev-develop استفاده میشود. در پروژههای قدیمی ممکن است شاخه اصلی master باشد. نسخههای شاخهای را با محدودیت پایداری مناسب مدیریت کنید.
composer require acme/catalog:dev-mainمخزن خصوصی و امنیت
برای مخزن خصوصی باید دسترسی شبکه و احراز هویت را تنظیم کنید. Token را داخل فایل عمومی پروژه قرار ندهید. از HTTPS استفاده کنید، دسترسی Token را محدود کنید و در صورت امکان از Secretهای محیط CI/CD استفاده کنید. برای مخزن Composer، فایل metadata باید اطلاعات نام، نسخه و محل dist یا source را ارائه دهد.
نکته مهم
مخزنهای تعریفشده در composer.json وابستگیها بهصورت بازگشتی از فایل composer.json بستههای دیگر بارگذاری نمیشوند. مخزن خصوصی را در پروژه ریشه تعریف کنید.