معيار التحميل التلقائي PSR-4

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

‏PSR-4 هو معيار يحدد كيفية تحميل classes في PHP تلقائيًا استنادًا إلى namespace وموقع file. وبدلًا من تضمين file الخاص بكل class يدويًا، يتيح PSR-4 لـ PHP العثور على classes وتحميلها تلقائيًا عند استخدامها.

القاعدة الأساسية بسيطة: يجب أن يتطابق namespace مع بنية directory. إذا كان لديك class App\Models\User، فيجب أن يكون file موجودًا في App/Models/User.php.

<?php
// ملف: src/Models/User.php
namespace App\Models;

class User {
    public $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
}

يمكنك كتابة دالة autoloader بسيطة تتبع قواعد PSR-4:

<?php
// ملف: autoload.php
spl_autoload_register(function ($class) {
    $prefix = 'App\\';
    $baseDir = __DIR__ . '/src/';
    
    // تحقق مما إذا كانت الفئة تستخدم بادئة مساحة الاسم الخاصة بنا
    if (strpos($class, $prefix) === 0) {
        $relativeClass = substr($class, strlen($prefix));
        $file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
        
        if (file_exists($file)) {
            require $file;
        }
    }
});

تخبر الدالة spl_autoload_register PHP باستدعاء function الخاصة بك كلما واجهت class غير معروفة. تقوم function بتحويل namespace إلى file path وتحمله.

النقطة الأساسية: ينشئ PSR-4 تعيينًا متوقعًا بين مساحات الأسماء ومسارات الملفات. عندما ترى App\Models\User، تعرف فورًا أن الملف موجود في src/Models/User.php. تجعل هذه الاتفاقية المشاريع أسهل في التنقل والصيانة.

التحدي

سهل

لنقم ببناء نظام تحميل تلقائي PSR-4 بسيط يقوم بتحميل الـ classes تلقائيًا بناءً على الـ namespace وموقع الـ file الخاص بها.

ستقوم بـ Create مشروع بثلاثة ملفات توضح كيف يربط PSR-4 الـ namespaces بمسارات الـ directory:

src/Services/Logger.php: Define a Logger class في الـ App\Services namespace. يجب أن تحتوي على خاصية public $name، وconstructor that accepts and sets the name، وmethod log($message) تُرجع "[name] logged: [message]".
src/Services/Mailer.php: Define a Mailer class في الـ App\Services namespace. يجب أن تحتوي على خاصية public $sender، وconstructor that accepts and sets the sender، وmethod send($to) تُرجع "Mail from [sender] to [to]".
main.php: Create a PSR-4 autoloader باستخدام spl_autoload_register يربط الـ App\ namespace prefix بالـ src/ directory. يجب على الـ autoloader أن convert فواصل الـ namespace إلى فواصل الـ directory وappend .php للعثور على الـ file الصحيح. بعد تسجيل الـ autoloader، استخدم الـ use keyword لـ import كلا الـ classes، ثم أنشئ Logger بالاسم "FileLogger" وMailer مع sender "admin@site.com". Print نتيجة استدعاء log("System started") على الـ logger وsend("user@example.com") على الـ mailer (كلٌّ في سطره الخاص).

الفكرة الأساسية هي أن function الـ autoloader لديك تستقبل اسم الـ class المؤهل بالكامل (مثل App\Services\Logger) ويجب أن تقوم بـ convert له إلى مسار file (src/Services/Logger.php). استخدم strpos للتحقق مما إذا كان الـ class يبدأ بـ namespace prefix الخاص بك، وsubstr للحصول على اسم الـ class النسبي، وstr_replace لـ convert الشرطات المائلة العكسية إلى شرطات مائلة أمامية.

جرّب بنفسك

<?php
// تنفيذ محمّل PSR-4 التلقائي

// TODO: سجّل محمّلاً تلقائياً باستخدام spl_autoload_register
// يجب أن يقوم المحمّل التلقائي بما يلي:
// 1. تحقق مما إذا كانت الفئة تبدأ ببادئة مساحة الاسم 'App\'
// 2. أزل بادئة 'App\' للحصول على اسم الفئة النسبي
// 3. حوّل فواصل مساحة الاسم (\) إلى فواصل الدليل (/)
// 4. أضف 'src/' في البداية و'.php' في النهاية لبناء مسار الملف
// 5. قم بـ require للملف إذا كان موجوداً

spl_autoload_register(function ($class) {
    // TODO: عرّف بادئة مساحة الاسم والدليل الأساسي
    
    // TODO: تحقق مما إذا كانت الفئة تستخدم بادئة مساحة الاسم (استخدم strpos)
    
    // TODO: احصل على اسم الفئة النسبي (استخدم substr)
    
    // TODO: ابنِ مسار الملف باستبدال \ بـ / (استخدم str_replace)
    
    // TODO: قم بتضمين الملف إذا كان موجودًا
});

// TODO: استخدم الكلمة المفتاحية 'use' لاستيراد فئات Logger و Mailer

// TODO: أنشئ مثيلًا من Logger بالاسم "FileLogger"

// TODO: أنشئ مثيلًا من Mailer بالمرسل "admin@site.com"

// TODO: اطبع نتيجة log("System started")

// TODO: اطبع نتيجة send("user@example.com")
?>