في الوقت الحاضر، من الشائع جدًا أن تعتمد وحدات دروبال المساهمة على مكتبات الطرف الثالث. لا يمكن تثبيت بعض هذه الوحدات إلا باستخدام Composer. إذا كنت قد جلبت بالفعل Drupal core باستخدام Composer، أو إذا كانت الوحدة تتطلب Composer، فيجب عليك استخدام Composer لتنزيل جميع الوحدات النمطية والموضوعات الخاصة بك. إذا قمت بخلط تحديثات Composer ومطابقتها بطرق أخرى، فقد تواجه بعض مشكلات التحديث المزعجة إلى حد ما.

احصل على الوحدات والمواضيع المساهمة باستخدام Composer

إذًا، هل تريد تنزيل وحدات أو سمات Drupal المساهمة باستخدام Composer؟ إليك الطريقة:

  • نوع composer require drupal/module_name
  • على سبيل المثال: composer require drupal/token
  • تأكد من أنك في جذر تثبيت Drupal الخاص بك

سيقوم Composer بعد ذلك بتحديث ملف Composer.json الخاص بك بذكاء، مضيفًا الوحدة إلى قائمة المتطلبات الأخرى، كما يلي:

 { "require": { "drupal/token": "^1.5" } }

سيقوم الملحن بتنزيل الوحدة وأي تبعيات محتملة قد تكون موجودة فيها.

الآن، لتمكين وحدة دروبال، لديك خياران:

  • استخدم واجهة متصفح الويب القياسية Drupal بالنقر فوق "توسيع" في شريط الأدوات.
  • جرّب أداة سطر أوامر مثل Drush أو Drupal Console - راجع تثبيت الوحدات من سطر الأوامر .

عند الحاجة إلى وحدات، يمكنك استخدام اسم المشروع أو اسم الوحدة المحددة داخل المشروع:

  • سيقوم الملحن بتنزيل المشروع بأكمله الذي يحتوي على وحدة معينة.
  • على سبيل المثال، إذا كنت بحاجة إلى وحدة fe_block من مشروع Features_extra ، فيمكنك اختيار أحد الخيارات التالية:
    • composer require drupal/features_extra
    • composer require drupal/fe_block

اختيار الإصدار

إذا كنت ترغب في تحديد إصدار الوحدة أو السمة التي تريد تنزيلها، فافعل ذلك على النحو التالي:

 composer require 'drupal/module_name:version'

(ما عليك سوى استبدال version بإصدار Composer الفعلي أو قيد الإصدار.)

على سبيل المثال:

 composer require 'drupal/dxpr_builder:^1.1' composer require 'drupal/dxpr_builder:~1.1' composer require 'drupal/dxpr_builder:2.2.2-alpha2' composer require 'drupal/dxpr_builder:2.2.x-dev'

لتجنب أي عوائق في المحطات أو الأصداف المختلفة، قم بإحاطة الإصدار بين علامتي اقتباس، تمامًا كما في الأمثلة أعلاه.

انتباه! في نظام التشغيل Windows، قد يؤدي استخدام علامات الاقتباس (المفردة) إلى إفساد مواصفات الإصدار، مما يتسبب في فشل التثبيت مع ' تعذر تحليل قيد الإصدار .....': سلسلة إصدار غير صالحة "....'" .

بدون علامات الاقتباس، على سبيل المثال:

 composer require drupal/dxpr_builder:^2.2

أو استخدام علامات الاقتباس المزدوجة بدلاً من علامات الاقتباس المفردة، كما يلي:

 composer require "drupal/dxpr_builder:^2.2"

يجب أن تعمل على ما يرام. لمزيد من المعلومات، راجع التعليق "مشكلات الملحن: "تعذر تحليل قيد الإصدار"' .

في الأمثلة أعلاه، تتوافق الإصدارات على النحو التالي:

  • ^1.1: تعيينات لأحدث إصدار ثابت 10.x-1.x للوحدة.
  • ~1.1: تعيين لأحدث إصدار ثابت 10.x-3.x للوحدة.
  • 2.2.2-alpha2: خرائط للإصدار 2.2.2-alpha2
  • 2.2.x-dev: خرائط لـ 2.2.x-dev

لمعرفة المزيد حول قيود الإصدار باستخدام ~ (تيلدا) و^ (علامة الإقحام)، قم بإلقاء نظرة على Next Significant Release Operators .

إنها فكرة جيدة أن تحدد إصدار الوحدة المساهمة التي تريد تنزيلها.


باستخدام البحث الملحن

أخبار جيدة! تدعم نقاط نهاية الملحن في Drupal.org وظيفة بحث الملحن . وهذا يعني أنه يمكنك البحث عن مشاريع دروبال مباشرة من سطر الأوامر. لاستخدام بحث الملحن، اكتب:

 composer search views

باستخدام تصفح الملحن

تدعم نقاط نهاية الملحن في Drupal.org لـ Drupal من 7 إلى 10 أيضًا وظيفة تصفح الملحن . يتيح لك ذلك العثور على معلومات إضافية حول مشاريع دروبال مباشرة من سطر الأوامر. لاستخدام تصفح Composer، اكتب:

 composer browse drupal/token