كيفية تثبيت Composer على أوبونتو

كيفية تثبيت واستخدام Composer على Ubuntu 16.04

في عالم تطوير البرمجيات، يُعتبر Composer أداة حيوية لإدارة مكتبات PHP وإدارتها. فهو يسهل على المطورين تحميل مكتبات PHP المختلفة وإدارتها بطريقة أكثر فاعلية وتنظيمًا. في هذا المقال، سوف نستعرض كيفية تثبيت واستخدام Composer على نظام Ubuntu 16.04.

ما هو Composer؟

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

متطلبات تثبيت Composer

قبل البدء في تثبيت Composer على Ubuntu 16.04، هناك بعض المتطلبات التي يجب أن تكون موجودة على النظام لضمان عمل Composer بشكل صحيح:

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

   bash
   CopyEdit
   php -v
   

   إذا لم يكن PHP مثبتًا، يمكنك تثبيته باستخدام:

   bash
   CopyEdit
   sudo apt update
   sudo apt install php
   

2. تثبيت الإضافات (Extensions): Composer قد يحتاج بعض الإضافات الخاصة بـ PHP مثل curl و json. إذا لم تكن هذه الإضافات مثبتة بالفعل، يمكنك تثبيتها عبر:

   bash
   CopyEdit
   sudo apt install php-curl php-json
   

خطوات تثبيت Composer على Ubuntu 16.04

1. تحديث النظام

أول خطوة يجب أن تقوم بها هي تحديث النظام لضمان أنك تعمل على آخر إصدار من الحزم. قم بتشغيل الأوامر التالية لتحديث الحزم في Ubuntu:

bash
CopyEdit
sudo apt update
sudo apt upgrade

2. تنزيل Composer باستخدام cURL

بمجرد تحديث النظام، يمكنك تنزيل Composer من خلال cURL، الذي يُستخدم لتحميل الملفات من الإنترنت. إذا لم يكن لديك cURL على جهازك، يمكنك تثبيته عبر:

bash
CopyEdit
sudo apt install curl

الآن يمكنك تنزيل ملف Composer باستخدام الأمر التالي:

bash
CopyEdit
curl -sS https://getcomposer.org/installer | php

سيقوم هذا الأمر بتنزيل البرنامج النصي لتثبيت Composer ومن ثم تشغيله باستخدام PHP. عند اكتمال العملية بنجاح، ستلاحظ أن ملف composer.phar قد تم إنشاؤه في الدليل الحالي.

3. نقل Composer إلى مسار مناسب

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

bash
CopyEdit
sudo mv composer.phar /usr/local/bin/composer

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

bash
CopyEdit
composer

4. التحقق من التثبيت

للتحقق من أن Composer قد تم تثبيته بنجاح، يمكنك تنفيذ الأمر التالي:

bash
CopyEdit
composer --version

إذا كانت جميع الأمور تسير كما ينبغي، سيعرض هذا الأمر رقم الإصدار الخاص بـ Composer، مما يعني أن التثبيت تم بنجاح.

استخدام Composer على Ubuntu 16.04

1. إنشاء مشروع جديد باستخدام Composer

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

bash
CopyEdit
composer create-project --prefer-dist vendor/project [directory]

استبدل “vendor/project” باسم الحزمة أو المكتبة التي تريد تنزيلها، مثل laravel/laravel، و “directory” هو المجلد الذي سيحتوي على المشروع الجديد.

على سبيل المثال، لإنشاء مشروع Laravel جديد، يمكنك تنفيذ:

bash
CopyEdit
composer create-project --prefer-dist laravel/laravel my-laravel-project

2. إضافة مكتبات إلى مشروعك

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

bash
CopyEdit
composer require vendor/package

على سبيل المثال، إذا كنت تريد إضافة مكتبة guzzlehttp/guzzle، التي تُستخدم لإجراء طلبات HTTP، يمكنك تنفيذ:

bash
CopyEdit
composer require guzzlehttp/guzzle

سيقوم Composer تلقائيًا بتحميل المكتبة وتحديث ملف composer.json ليتضمن المكتبة المُضافة.

3. تحديث التبعيات

من وقت لآخر، قد ترغب في تحديث التبعيات في مشروعك إلى أحدث الإصدارات. يمكنك فعل ذلك عبر تنفيذ:

bash
CopyEdit
composer update

سيقوم Composer بالبحث عن تحديثات للمكتبات المثبتة وتثبيتها إذا كانت متاحة.

4. إدارة التبعيات في ملف composer.json

يعد composer.json هو ملف التكوين الذي يُستخدم لتعريف تبعيات المشروع. يقوم Composer بتخزين جميع التبعيات التي تم تثبيتها في هذا الملف، ويتيح لك إدارة هذه التبعيات بسهولة. عند إضافة مكتبة باستخدام الأمر composer require، يتم تحديث هذا الملف تلقائيًا.

تستطيع أيضًا تعديل الملف يدويًا لإضافة أو تعديل التبعيات، مثل:

json
CopyEdit
{
    "require": {
        "guzzlehttp/guzzle": "^7.0",
        "monolog/monolog": "^2.0"
    }
}

5. تثبيت التبعيات من ملف composer.json

إذا كان لديك مشروع يحتوي على composer.json بالفعل وتريد تثبيت التبعيات المحددة في هذا الملف، يمكنك استخدام الأمر التالي:

bash
CopyEdit
composer install

سيقوم هذا الأمر بقراءة التبعيات المُدرجة في composer.json وتثبيتها.

حل المشكلات الشائعة

في بعض الأحيان، قد تواجه بعض المشكلات أثناء تثبيت واستخدام Composer على Ubuntu 16.04. فيما يلي بعض المشاكل الشائعة وكيفية حلها:

1. المشكلة: “PHP extension ‘xx’ is required”

   الحل: قد تحتاج إلى تثبيت بعض الإضافات المفقودة. يمكنك تثبيت الإضافات المطلوبة باستخدام:

   bash
   CopyEdit
   sudo apt install php-xx
   

2. المشكلة: “Composer not found”

   الحل: تأكد من أنك قد نقلت الملف إلى المسار الصحيح، وتحقق من وجوده في المجلد /usr/local/bin/composer عبر:

   bash
   CopyEdit
   which composer
   

3. المشكلة: “Memory limit exceeded”

   الحل: إذا واجهت مشكلة في تجاوز الحد الأقصى لذاكرة PHP، يمكنك زيادة الحد عبر تعديل ملف php.ini وتغيير قيمة memory_limit، أو باستخدام الأمر التالي:

   bash
   CopyEdit
   php -d memory_limit=-1 composer install
   

الخاتمة

تثبيت واستخدام Composer على Ubuntu 16.04 هو أمر بسيط ومباشر إذا تم اتباع الخطوات بشكل صحيح. بتثبيت Composer، يمكن للمطورين إدارة مكتبات PHP بشكل أكثر كفاءة، مما يساهم في تسريع عملية التطوير وتنظيم الكود. باستخدام الأوامر التي تم شرحها في هذا المقال، يمكنك تثبيت وتحديث وإدارة التبعيات الخاصة بمشاريع PHP بكل سهولة.