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

بخش config در فایل composer.json رفتار خود Composer را برای پروژه تنظیم می‌کند. این گزینه‌ها روی شیوه نصب بسته‌ها، محل ذخیره فایل‌ها، احراز هویت، ارتباط امن، Autoloader و محدودیت‌های محیط اجرا اثر می‌گذارند. تنظیمات می‌توانند در سطح پروژه یا در فایل تنظیمات سراسری کاربر قرار بگیرند.

تنظیم شیوه دریافت بسته‌ها

preferred-install مشخص می‌کند Composer بین source و dist کدام روش را ترجیح دهد. dist برای نصب سریع در سرور Build مناسب است و source برای زمانی که می‌خواهید کد وابستگی را تغییر دهید کاربرد دارد. process-timeout حداکثر زمان اجرای فرایندهایی مانند Git Clone را تعیین می‌کند و مقدار پیش‌فرض آن ۳۰۰ ثانیه است.

{
  "config": {
    "preferred-install": {"*": "dist", "acme/*": "source"},
    "process-timeout": 600
  }
}

مسیرها و پوشه‌ها

vendor-dir محل نصب وابستگی‌ها را مشخص می‌کند و مقدار پیش‌فرض آن vendor است. bin-dir مسیر فایل‌های اجرایی بسته‌ها را تعیین می‌کند و معمولاً vendor/bin است. گزینه‌های cache-dir، cache-files-dir، cache-repo-dir و cache-vcs-dir محل داده‌های کش را کنترل می‌کنند. data-dir برای داده‌های پایدارتر Composer استفاده می‌شود.

Autoloader و کارایی

optimize-autoloader نگاشت PSR-0 و PSR-4 را برای محیط Production به Classmap تبدیل می‌کند تا جست‌وجوی کلاس سریع‌تر شود. classmap-authoritative جست‌وجو را به Classmap محدود می‌کند و فقط وقتی مناسب است که همه کلاس‌ها در زمان ساخت شناخته شده باشند. apcu-autoloader نتیجه جست‌وجوی کلاس‌ها را در APCu نگه می‌دارد.

composer install --no-dev --optimize-autoloader

امنیت ارتباط و احراز هویت

secure-http به‌صورت پیش‌فرض دریافت از HTTPS را الزامی می‌کند. disable-tls با غیرفعال کردن رمزنگاری ارتباط، ریسک امنیتی جدی ایجاد می‌کند و نباید برای حل خطای گواهی فعال شود. گزینه‌های github-oauth، gitlab-oauth، gitlab-token، bitbucket-oauth و http-basic برای دسترسی به مخزن‌های خصوصی هستند. اطلاعات حساس را می‌توان در auth.json نگه داشت تا وارد مخزن کد نشوند.

{
  "config": {
    "secure-http": true,
    "github-protocols": ["https", "ssh"]
  }
}

Platform و سازگاری

گزینه platform اجازه می‌دهد نسخه PHP یا افزونه‌های مورد انتظار پروژه را در حل وابستگی‌ها شبیه‌سازی کنید. این کار برای هماهنگ کردن محیط توسعه با سرور Production مفید است، اما جایگزین بررسی واقعی محیط اجرا نیست. platform-check نیز در زمان اجرای Autoloader می‌تواند سازگاری محیط را بررسی کند.

{
  "config": {
    "platform": {
      "php": "7.1.3",
      "ext-mbstring": "1.0"
    }
  }
}

نکته مهم

گزینه‌های امنیتی را برای عبور موقت از خطاهای TLS غیرفعال نکنید. اگر اتصال HTTPS شکست می‌خورد، CA bundle و افزونه OpenSSL و ساعت سیستم را بررسی کنید.

مطالعه مرتبط

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