• 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 بسته‌های دیگر بارگذاری نمی‌شوند. مخزن خصوصی را در پروژه ریشه تعریف کنید.

مطالعه مرتبط

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