أداة التحميل التلقائي Composer

جزء من قسم البرمجة كائنية التوجه في رحلة PHP على Coddy. الدرس 13 من 91.

تعمل كتابة autoloader الخاص بك، لكن مشاريع PHP الحقيقية تستخدم Composer للتعامل مع autoloading تلقائيًا. يقرأ Composer إعدادات مشروعك وينشئ autoloader مُحسّنًا يتبع معايير PSR-4.

يوجد الإعداد في ملف composer.json في جذر مشروعك. إليك كيفية تعريف قواعد autoloading:

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

يُخبر هذا Composer بأن أي class يبدأ بـ App\ يجب تحميله من directory src/. بعد إعداد ذلك، يُنشئ Composer ملفات autoloader في directory vendor/.

لاستخدام autoloader الخاص بـ Composer، تحتاج فقط إلى سطر واحد في أعلى ملف الدخول الخاص بك:

<?php
require 'vendor/autoload.php';

use App\Models\User;
use App\Services\Logger;

$user = new User("Alice");
$logger = new Logger();

يتولى بيان require واحد تحميل جميع أصناف class في مشروعك بالكامل. يمكنك تعريف تعيينات متعددة لـ namespace إذا لزم الأمر:

{
    "autoload": {
        "psr-4": {
            "App\\": "src/",
            "Tests\\": "tests/"
        }
    }
}

نقطة أساسية: يعمل autoloader الخاص بـ Composer على إلغاء عمليات تضمين file يدويًا، ويضمن تحميل class بشكل متسق عبر مشروعك. وهو النهج القياسي الذي تستخدمه جميع تطبيقات وأطر عمل PHP الحديثة تقريبًا.

التحدي

سهل

لنَبْنِ تطبيقًا صغيرًا يستخدم أسلوب autoloading الخاص بـ Composer لتنظيم class عبر ملفات متعددة. ستحاكي كيفية تنظيم مشروع PHP حقيقي لشفرتِه باستخدام namespaces بنمط PSR-4 وautoloader مركزي.

ستنشئ أربعة ملفات تعمل معًا:

src/Models/Product.php: عرّف Product class في namespace App\Models. يجب أن يحتوي على خاصيتي public $name وpublic $price، وconstructor يقبل القيمتين ويضبطهما، وgetInfo() method تُعيد "[name]: $[price]".
src/Models/Customer.php: عرّف Customer class في namespace App\Models. يجب أن يحتوي على خاصية public $name، وconstructor يقبل الاسم ويضبطه، وgreet() method تُعيد "Welcome, [name]!".
vendor/autoload.php: أنشئ autoloader بسيطًا باستخدام spl_autoload_register يحاكي سلوك Composer. يجب أن يربط prefix الخاص بـ namespace App\ بالدليل src/، مع تحويل فواصل namespaces إلى فواصل أدلة وإضافة .php لتحميل الملف الصحيح.
index.php: هذا هو ملف نقطة الدخول الخاص بك. استخدم vendor/autoload.php مع تعليمة require واحدة لتحميل autoloader، ثم استخدم keyword use لاستيراد كل من App\Models\Product وApp\Models\Customer. أنشئ Product بالاسم "Laptop" والسعر 999، وأنشئ Customer بالاسم "Alice". اطبع result استدعاء greet() على customer واستدعاء getInfo() على product، بحيث يظهر كل منهما في سطر مستقل.

المفهوم الأساسي هنا هو أن index.php يحتاج إلى تعليمة require واحدة فقط لتحميل autoloader؛ وبعد ذلك، تُحمَّل جميع classes تلقائيًا عند استخدامها. هذه هي الطريقة نفسها التي تعمل بها أطر عمل وتطبيقات PHP الحديثة مع Composer.

جرّب بنفسك

<?php
// TODO: قم بـ require للـ autoloader من vendor/autoload.php

// TODO: استخدم الكلمة المفتاحية 'use' لاستيراد App\Models\Product

// TODO: استخدم الكلمة المفتاحية 'use' لاستيراد App\Models\Customer

// TODO: أنشئ Product بالاسم "Laptop" والسعر 999

// TODO: أنشئ Customer بالاسم "Alice"

// TODO: اطبع نتيجة greet() الخاصة بالعميل

// TODO: اطبع نتيجة getInfo() الخاصة بالمنتج
?>