كيف تعمل المساحات الأسماء (Namespaces) في PHP؟

Question

Accepted Answer

**المساحات الأسماء** تنظم كود PHP وتمنع **تضارب الأسماء** بين الفئات (classes) والدوال والثوابت — وهذا ضروري جداً مع نمو التطبيقات واستخدام الحزم من جهات خارجية. تعمل مثل المجلدات (directories) لأسماء الفئات، وتتكامل مع تحميل Composer الآلي (PSR-4).

## المشكلة التي تحلها المساحات الأسماء

```text
Without namespaces, two classes named `User` (yours and a library's) would COLLIDE
("cannot redeclare class"). Namespaces give each a unique fully-qualified name.
```

## إعلان واستخدام المساحات الأسماء

```php
<?php
// declare a namespace at the top of the file (matches the directory, PSR-4)
namespace App\Models;

class User {            // fully-qualified name: App\Models\User
    // ...
}
```

```php
<?php
namespace App\Controllers;

use App\Models\User;            // IMPORT a class so you can use its short name
use App\Services\Mailer as MailService;   // import with an ALIAS

class UserController {
    public function index() {
        $user = new User();      // short name works thanks to the `use` import
        // or use the fully-qualified name: new \App\Models\User();
    }
}
```

ملف يُعلن `namespace`، وملفات أخرى تستخدم `use` (استيراد) الفئات للإشارة إليها باسم مختصر. الاسم الكامل المؤهل (`\App\Models\User`) فريد عالمياً.

## المساحات الأسماء تقابل المجلدات (PSR-4)

```text
Namespace            File path
App\Models\User   →  src/Models/User.php
App\Services\Mailer → src/Services/Mailer.php
→ PSR-4 autoloading: the namespace structure mirrors the folder structure, so
  Composer can find and load each class automatically (no manual require).
```

## استيراد الدوال والثوابت والمساحة الأسماء العامة

```php
use function App\Helpers\format;     // import a function
use const App\Config\VERSION;        // import a constant

\strlen("x");    // a leading \ = the GLOBAL namespace (built-in functions)
```

## لماذا هذا مهم

المساحات الأسماء ضرورية لتنظيم كود PHP الحديث وهي أساسية لطريقة عمل النظام البيئي بالكامل.

فهمها مهم لأنها تحل مشكلة حرجة وهي **تضارب الأسماء** — بدون المساحات الأسماء، ستتضارب فئاتك مع بعضها البعض وتتضارب مع الكثير من الحزم الخارجية التي يستخدمها التطبيق الحقيقي (لا يمكن أن تتواجد فئتا `User` في نفس الوقت)، مما يجعل التطبيقات الكبيرة والنظم البيئية للحزم مستحيلة..

المساحات الأسماء تعطي كل فئة اسماً مؤهلاً فريداً عالمياً، و**استيرادات `use`** تسمح لك بالإشارة للفئات باسم مختصر بشكل نظيف.

الأهم من ذلك، المساحات الأسماء تتكامل مع **تحميل Composer الآلي عبر PSR-4**، حيث تعكس بنية المساحة الأسماء بنية المجلدات بحيث يتم تحميل الفئات تلقائياً عند الحاجة — وهذا هو أساس بنية مشروع PHP الحديث وإدارة الاعتماديات..

لأن كل إطار عمل PHP حديث وكل حزمة وكل تطبيق يتم تنظيمه بالمساحات الأسماء (ولا يمكنك استخدام حزم Composer بدون فهمها)، معرفة كيفية إعلان المساحات الأسماء، استيراد الفئات مع `use`، وكيفية تعيينها للمجلدات للتحميل الآلي هي معرفة أساسية يومية لأي تطوير PHP حديث.

المساحات الأسماء و Composer و تحميل PSR-4 الآلي معاً تحدد كيفية تنظيم مشاريع PHP المعاصرة.