مقدمة إلى مساحات الأسماء

جزء من قسم Object Oriented Programming في رحلة PHP على Coddy — الدرس 10 من 91.

مع نمو مشاريع PHP الخاصة بك، ستنشئ العديد من الـ classes. ماذا يحدث عندما يكون لـ classين الاسم نفسه؟

على سبيل المثال، قد يكون لديك class باسم User لمدونتك و class User آخر لمتجرك. تحل الـ Namespaces هذه المشكلة من خلال تنظيم الـ classes في مجموعات منطقية.

تُعد مساحة الاسم (namespace) بمثابة مجلد لفئاتك. تقوم بالتصريح عنها في الجزء العلوي من ملف PHP الخاص بك باستخدام الكلمة المفتاحية namespace:

<?php
namespace Blog;

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

الآن يمكنك الحصول على فئة User أخرى في مساحة أسماء مختلفة:

<?php
namespace Shop;

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

لاستخدام فئة ذات مساحة اسم (namespaced class)، يمكنك الإشارة إليها بمسارها الكامل باستخدام الشرطة المائلة العكسية (backslash):

<?php
$blogUser = new \Blog\User("Alice");
$shopUser = new \Shop\User("alice@example.com");

echo $blogUser->name . "\n";
echo $shopUser->email . "\n";

المخرجات:

Alice
alice@example.com

تُفصل الشرطة المائلة العكسية \ مستويات مساحة الاسم (namespace)، بشكل مشابه لكيفية فصل الشرطات المائلة للمجلدات في مسار الملف. يمكنك أيضاً إنشاء مساحات أسماء متداخلة مثل App\Models\Blog لتنظيم أعمق.

نقطة رئيسية: تمنع مساحات الأسماء (Namespaces) تعارض التسمية وتحافظ على تنظيم الكود الخاص بك. قم دائمًا بالتصريح عن مساحة الأسماء قبل أي كود آخر في ملفك (باستثناء بيانات declare).

التحدي

سهل

دعونا ننظم تطبيقاً صغيراً باستخدام مساحات الأسماء (namespaces) لمنع تضارب التسمية بين الفئات (classes) التي تحمل الاسم نفسه.

تخيل أنك تقوم ببناء نظام يتعامل مع كل من المركبات والحيوانات. كلا المجالين يحتويان على كيان يسمى Car — أحدهما يمثل سيارة حقيقية، بينما الآخر هو قط أليف يسمى "Car" (نعم، بعض الناس يسمون قططهم بهذا الاسم!).

ستقوم بإنشاء ثلاثة ملفات:

Vehicle/Car.php — قم بتعريف فئة Car داخل مساحة الاسم Vehicle مع خاصية public $brand. يجب أن يقبل المنشئ (constructor) اسم العلامة التجارية ويقوم بتعيينه. أضف طريقة describe() التي تعيد "Vehicle: [brand]".
Animal/Car.php — قم بتعريف فئة Car داخل مساحة الاسم Animal (هذا قط يسمى Car!). يجب أن تحتوي على خاصية public $age. يقبل المنشئ العمر ويقوم بتعيينه. أضف طريقة describe() التي تعيد "Cat named Car, age: [age]".
main.php — قم بتضمين كلا ملفي الفئات باستخدام require_once. أنشئ كائناً واحداً من كل مساحة اسم باستخدام مسارات مساحة الاسم الكاملة الخاصة بهما، ثم اطبع نتيجة استدعاء describe() لكل كائن (كل منهما في سطر مستقل).

في main.php، قم بإنشاء:

كائن Vehicle\Car بالعلامة التجارية "Toyota"
كائن Animal\Car بالعمر 3

تذكر استخدام الشرطة المائلة العكسية \ للإشارة إلى الفئات ذات مساحات الأسماء بمسارها الكامل عند إنشاء الكائنات.

ورقة مرجعية

تنظم مساحات الأسماء (Namespaces) الفئات (classes) في مجموعات منطقية وتمنع تعارض التسمية عندما تشترك فئات متعددة في نفس الاسم.

قم بالتصريح عن مساحة اسم في الجزء العلوي من ملف PHP باستخدام الكلمة المفتاحية namespace:

<?php
namespace Blog;

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

يمكنك الحصول على فئات بنفس الاسم في مساحات أسماء مختلفة:

<?php
namespace Shop;

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

لاستخدام فئة تابعة لمساحة اسم، قم بالإشارة إليها بمسارها الكامل باستخدام الشرطة المائلة العكسية \:

<?php
$blogUser = new \Blog\User("Alice");
$shopUser = new \Shop\User("alice@example.com");

echo $blogUser->name . "\n";
echo $shopUser->email . "\n";

تفصل الشرطة المائلة العكسية بين مستويات مساحة الاسم، بشكل مشابه لمسارات المجلدات. يمكنك إنشاء مساحات أسماء متداخلة مثل App\Models\Blog.

هام: قم دائمًا بالتصريح عن مساحة الاسم قبل أي كود آخر في ملفك (باستثناء عبارات declare).

جرّب بنفسك

<?php
// تضمين ملفات الفئات
require_once 'Vehicle/Car.php';
require_once 'Animal/Car.php';

// TODO: قم بإنشاء كائن من Vehicle\Car بالعلامة التجارية "Toyota"
// تذكر استخدام مسار مساحة الاسم الكامل مع الشرطة المائلة العكسية

// TODO: قم بإنشاء كائن من Animal\Car بالعمر 3
// تذكر استخدام مسار مساحة الاسم الكامل مع الشرطة المائلة العكسية

// TODO: اطبع نتيجة describe() لكل كائن (كل واحد في سطر منفصل)

?>