مقدمة إلى استخدام Composer في PHP

تمت الكتابة بواسطة: عبد الحكيم

تارخ آخر تحديث: 02 سبتمبر 2024

محتوى المقال

ما هو Composer؟
لماذا نستخدم Composer؟
تثبيت Composer
تهيئة مشروع جديد باستخدام Composer
إضافة حزم إلى مشروعك
تحديث الحزم المثبتة
تحميل الحزم التلقائي (Autoloading)
الخلاصة

Composer هو مدير حزم يعتمد عليه في PHP ويستخدم بشكل رئيسي لإدارة تبعيات المشروع، مما يسمح لك بتحديد المكتبات التي يعتمد عليها مشروعك تلقائيًا. في هذا الدليل، سنتعرف على كيفية استخدام Composer في مشاريع PHP الخاصة بك.

ما هو Composer؟

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

لماذا نستخدم Composer؟

يوفر Composer العديد من الفوائد لمطوري PHP:

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

تثبيت Composer

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


        # تنزيل Composer

        php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"


        # التحقق من سلامة الملف

        php -r "if (hash_file('sha384', 'composer-setup.php') === 'HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"


        # تثبيت Composer

        php composer-setup.php


        # حذف ملف الإعداد

        php -r "unlink('composer-setup.php');"

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

تهيئة مشروع جديد باستخدام Composer

للبدء في استخدام Composer في مشروع جديد، يمكنك إنشاء ملف composer.json الذي يحدد الحزم المطلوبة وتبعيات المشروع. يمكنك إنشاؤه يدويًا أو باستخدام الأمر التالي:


        composer init

سيسألك Composer بعض الأسئلة حول مشروعك، مثل الاسم والوصف والتبعيات المطلوبة، وسيقوم بإنشاء ملف composer.json تلقائيًا.

إضافة حزم إلى مشروعك

لإضافة حزمة جديدة إلى مشروعك، يمكنك استخدام الأمر composer require متبوعًا باسم الحزمة. على سبيل المثال، لإضافة حزمة guzzlehttp/guzzle، يمكنك تشغيل الأمر التالي:


        composer require guzzlehttp/guzzle

سيقوم Composer بتثبيت الحزمة المطلوبة وجميع التبعيات المرتبطة بها، وتحديث ملف composer.json لإضافة الحزمة.

تحديث الحزم المثبتة

لضمان أن مشروعك يستخدم أحدث الإصدارات من الحزم المثبتة، يمكنك استخدام الأمر composer update:


        composer update

سيقوم هذا الأمر بتحديث جميع الحزم إلى أحدث الإصدارات المتوافقة وفقًا لما هو محدد في ملف composer.json.

تحميل الحزم التلقائي (Autoloading)

يوفر Composer ميزة التحميل التلقائي للفئات (Classes) التي تستخدمها في مشروعك. بعد تثبيت حزمة جديدة، يمكنك تضمين ملف autoload.php في مشروعك لتمكين التحميل التلقائي:


        <?php

        // تضمين ملف autoload.php

        require 'vendor/autoload.php';


        // الآن يمكنك استخدام الحزم المثبتة بدون الحاجة إلى تضمينها يدوياً

        $client = new GuzzleHttp\Client();

بهذه الطريقة، يمكنك الاستفادة من ميزة التحميل التلقائي التي يوفرها Composer لتجنب التعقيدات المرتبطة بتضمين الملفات يدوياً.

الخلاصة

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