ملحن هو التطبيق الذي يستخدم ل إدارة التبعية بالتنسيق القياسي في بي أتش بي . يتيح لك Composer الإعلان عن المكتبات التي يوجد بها ملفك بي أتش بي المشروع يعتمد وإدارته بالنسبة لك. يقوم بتثبيت وتحديث المكتبات التي تحتاجها لمشروعك.

افتراضيًا، لا يقوم Composer بتثبيت أي شيء على مستوى العالم؛ فهو يدير التبعيات بناءً على كل مشروع ويقوم بتثبيتها في الدليل ( بائع ) داخل مشروعك.

يقدم الملحن شيئين لمشاريعنا:

CSS توسيط الصورة

• يساعد في إدارة التبعية لـ PHP.
• يساعد في التحميل التلقائي للملفات في المشروع.

يتم تنشيط الملحن بشكل كبير من خلال حزمة Node's NPM وRuby.

لنفترض السيناريو:

1. لديك مشروع PHP يعتمد على عدة مكتبات.
2. وتعتمد بعض هذه المكتبات أيضًا على مكتبات أخرى.

يفي الملحن بمتطلبات السيناريو أعلاه على النحو التالي:

1. يتيح لك الإعلان عن المكتبات التي يعتمد عليها مشروعك.
2. فهو يكتشف إصدارات الحزمة التي تحتاج إلى تثبيتها في مشروعك، ويقوم بتنزيلها وتثبيتها لك.
3. كما يسمح أيضًا بتحديث جميع التبعيات الخاصة بك في أمر واحد.

متطلبات النظام لتثبيت Composer:

يتطلب الملحن التثبيت والتشغيل بنجاح PHP 5.3.2+ على الجهاز. كما يتطلب أيضًا بعض إعدادات PHP الحساسة ويقوم بتجميع العلامات. عند تثبيت حزم Composer من المصدر بدلاً من الأرشيف المضغوط، سوف تحتاج إلى git أو svn أو Fossil أو hg بناءً على إصدار الحزمة الذي يتم التحكم فيه. الملحن هو أداة متعددة المنصات تعمل بشكل متساوٍ نظام التشغيل ويندوز , لينكس و ماك.

تثبيت الملحن على نظام التشغيل Windows

هناك طريقتان لتثبيت Composer على نظام التشغيل Windows: الطريقة الأولى تستخدم إعداد برنامج تثبيت Composer، والأخرى عن طريق التثبيت اليدوي باستخدام البرنامج النصي.

1. استخدام المثبت

أ) يعد تثبيت Composer باستخدام برنامج تثبيت Composer أسهل طريقة لتثبيته على نظام التشغيل Windows. قم بتشغيل المتصفح الافتراضي الخاص بك وقم بزيارة https://getcomposer.org وانقر على زر 'البدء'. تحت ' التثبيت - ويندوز 'القسم، انقر على' باستخدام المثبت ' خيار؛ سينقلك إلى قسم 'استخدام المثبت'.

ب) انقر على الملحن-Setup.exe رابط لتنزيل إعداد Composer على جهازك. بعد تنزيل الإعداد، قم بتشغيله للتثبيت واتبع التعليمات.

ج) افتح Composer-Setup الذي تم تنزيله وانقر فوق 'التثبيت لجميع المستخدمين'، وهو الخيار الموصى به لتثبيت Composer setup.

د) في الشاشة المنبثقة، انقر فوق نعم للسماح بالتثبيت.

هـ) الآن، اختر نوع التثبيت الخاص بك وانقر فوق التالي

و) الآن، اختر مسار PHP لسطر الأوامر الذي تريد استخدامه، ثم حدد المربع لإضافة مسار PHP، ثم انقر فوق التالي .

ز) تظهر شاشة منبثقة لإعداد الملحن توفر خيارًا لاستخدام خادم وكيل للاتصال بالإنترنت. إذا كنت تريد استخدام خادم وكيل، ضع علامة في المربع وأدخل عنوان URL للوكيل؛ إذا لم يكن كذلك، اتركه وانقر على التالي نحن نتخطى هذا لأننا لا نستخدم أي خادم وكيل للاتصال بالإنترنت.

ح) إعداد Composer جاهز للتثبيت على جهاز الكمبيوتر الخاص بك؛ راجع إعداداتك وانقر على زر التثبيت.

ط) بعد تثبيت إعداد Composer، تظهر معلومات مهمة حول كيفية فتحه. اقرأ المعلومات، ثم انقر فوق 'التالي' وقم بذلك بعد التثبيت.

ي) انقر فوق الزر 'إنهاء' لإكمال التثبيت.

عندما يتم تثبيت الملحن على جهازك، افتح نوافذ الأوامر (cmd)، واكتب ملحن و اضغط يدخل مفتاح. إذا عرضت قائمة بالأوامر، فهذا يعني أنه تم تثبيت Composer بنجاح على جهاز الكمبيوتر الخاص بك.

2. التثبيت اليدوي

يمكنك تثبيت Composer في أي دليل تريده. في حالتنا، نقوم بالتثبيت في C:xampphtdocscomposersetup الدليل. افتح محطة الأوامر (cmd) وانتقل إلى موقع الدليل الذي تريد تثبيته (C:xampphtdocscomposersetup).

انسخ والصق البرنامج النصي التالي في ملفك كمد Terminal وتشغيله لتثبيت Composer. سيقوم تلقائيًا بتثبيت أحدث إصدار من الملحن في دليلك الحالي.

 php -r 'copy('https://getcomposer.org/installer', 'composer-setup.php');' php -r 'if (hash_file('sha384', 'composer-setup.php') === '756890a4488ce9024fc62c56153228907f1545c228516cbf63f885e036d37e9a59d27d63f46af1d4d07ee0f76181c7d3') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;' php composer-setup.php php -r 'unlink('composer-setup.php');' 

يتحقق برنامج التثبيت هذا من إعدادات php.ini فقط. إذا تم ضبط الإعدادات بشكل غير صحيح، فسوف يحذرك ويبدأ بتنزيل الأحدث الملحن.فار في الدليل الحالي (C:xampphtdocscomposersetup). إذا تم التثبيت بنجاح، ستظهر لك رسالة تم التثبيت بنجاح.

يجب أن تكون خطوط البرمجة الأربعة المذكورة أعلاه كافية لتنفيذ الأنشطة التالية:

• قم بتنزيل مثبت الملحن إلى الدليل الحالي.
• تحقق من شهادة مثبت الملحن SHA-384.
• قم بتشغيل مثبت الملحن.
• قم بإزالة مثبت الملحن.

ملاحظة: قد يتغير رمز البرنامج النصي بناءً على الإصدار الجديد الذي تم إصداره. للتحقق من البرنامج النصي لتثبيت إصدار جديد من Composer، قم بزيارة https://getcomposer.org/download/ .

ملاحظة: إذا ألقى البرنامج النصي خطأً ' لم يتم التعرف على php كأمر داخلي أو خارجي '. ثم تحقق من ضبط مسار PHP بشكل جيد في إعدادات متغيرات بيئة الكمبيوتر أم لا. لتعيين مسار PHP عالميًا لجهازك، انسخ مسار php حيث يوجد (C:xamppphp)، ثم قم بلصقه في إعدادات النظام المتقدمة، > متغيرات البيئة > يختار طريق وانقر على جديد . الآن، في اسم المتغير يكتب طريق وفي قيمة متغيرة ، الصق موقع php، على سبيل المثال، ج:xamppphp .

يمكنك التحقق من إصدار الملحن المثبت لديك باستخدام أمر الملحن -v في المسار الحالي. مثل:

 composer -v 

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

 C:xampphtdocscomposersetup>composer -v 

هنا، قمنا بتثبيت الإصدار الحالي من Composer 2.0.8 على أجهزتنا.

إنشاء جديد الملحن.بات الملف في نفس الدليل حيث يوجد ملف الملحن.فار حاضر.

باستخدام كمد

 C:xampphtdocscomposersetup>echo @php '%~dp0composer.phar' %*>composer.bat 

باستخدام بوويرشيل

 C:xampphtdocscomposersetup> Set-Content composer.bat '@php '%~dp0composer.phar' %*' 

بعض خيارات التثبيت البارزة الأخرى لـ Composer

--install-dir

يمكنك تثبيت Composer في دليل معين حيث تريد استخدام ملف --install-dir الخيار وتوفير اسم الدليل الهدف. على سبيل المثال:

 php composer-setup.php --install-dir=bin 

--اسم الملف

يمكنك أيضًا تحديد اسم الملف بخلاف اسمه الافتراضي (composer.phar) باستخدام الملف --اسم الملف خيار. على سبيل المثال:

 php composer-setup.php --filename=composer 

--إصدار

يسمح Composer بتثبيت الإصدار الخاص به باستخدام ملحق --إصدار الخيار مع توفير نسخة إصدار محددة. على سبيل المثال:

 php composer-setup.php --version=1.0.0-alpha8 

--يساعد

باستخدام --يساعد الخيار، يمكنك عرض خيارات الملحن المتنوعة لبيئة معينة. على سبيل المثال:

 --help 

تحديث وإلغاء تثبيت الملحن

إذا كنت تريد تحديث برنامج Composer الخاص بك أو إلغاء تثبيت أي من مديري التبعيات الخاصين به، فتأكد من تثبيت Git for Windows على جهازك. ومن هناك، يمكنك التحقق من تثبيت Composer عن طريق التشغيل --إصدار الأمر من المحطة. إذا قام الأمر بإرجاع رمز الإصدار، فهذا يعني أنه تم تثبيت الملحن، وأنك جاهز للخطوات التالية.

قبل تحديث برنامج Composer الخاص بك، تحقق من الإصدار الحالي المثبت على جهاز الكمبيوتر الخاص بك. يمكنك القيام بذلك عن طريق كتابة الأمر التالي في تطبيقك الطرفي:

سلسلة إلى int في جافا

 composer -- version 

أو

 composer -V 

تحديث الملحن

لتحديث الملحن نفسه، قم بتشغيل البرنامج النصي أدناه، وسوف يقوم بتحديث الملحن.

 composer self-update 

تحديث التبعية

نظرًا لأن Composer يدير مكتبة التبعيات الخاصة بمشروعك، يمكنك تحديث هذه التبعيات إذا لزم الأمر باستخدام الأمر أدناه:

 composer update 

إذا لم يكن لديك مشروع نشط يعمل بتبعيات Composer في دليلك الحالي، فسيعرض Composer رسالة تفيد بأنه غير قادر على العثور على الملحن.json ملف.

إلغاء تثبيت الحزم

لإلغاء تثبيت الحزم من Composer، قم بتشغيل الأمر أدناه:

 composer remove your_package_name 

تأكد من استبدال 'your_package_name' باسم الحزمة الفعلي في الأمر أعلاه. سيتم إلغاء تثبيت الحزمة من Composer.