PHP میں namespaces کیسے کام کرتے ہیں؟

Question

Accepted Answer

**Namespaces** PHP کوڈ کو منظم کرتے ہیں اور classes، functions اور constants کے درمیان **naming collisions** سے بچاتے ہیں — یہ ضروری ہے جیسے جیسے applications بڑی ہوں اور تیسری فریق کے packages استعمال کریں۔ وہ class names کے لیے directories کی طرح کام کرتے ہیں، اور Composer autoloading (PSR-4) کے ساتھ مربوط ہیں۔

## مسئلہ جو namespaces حل کرتے ہیں

```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.
```

## Namespaces کو اعلان اور استعمال کرنا

```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` اعلان کرتی ہے، اور دوسری فائلیں classes کو مختصر نام سے حوالہ دینے کے لیے `use` (import) کرتی ہیں۔ مکمل qualified نام (`\App\Models\User`) عالمی طور پر منفرد ہے۔

## Namespaces directories کے ساتھ map کرتے ہیں (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).
```

## Functions، constants اور global namespace کو import کرنا

```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)
```

## اہمیت

Namespaces جدید PHP کوڈ کو منظم کرنے کے لیے ضروری ہیں اور یہ پورے ecosystem کے کام کرنے کے لیے بنیادی ہیں۔

انہیں سمجھنا اہم ہے کیونکہ وہ **naming collisions** کے اہم مسئلے کو حل کرتے ہیں — namespaces کے بغیر، آپ کی classes ایک دوسرے سے اور بہت سارے تیسری فریق کے packages سے تنازعہ کریں گی جو ایک حقیقی application استعمال کرتا ہے (دو `User` classes بیک وقت موجود نہیں ہو سکتی)، بڑی applications اور package ecosystems کو ناممکن بناتے ہوئے۔

Namespaces ہر class کو ایک منفرد مکمل qualified نام دیتے ہیں، اور **`use` imports** آپ کو classes کو مختصر ناموں سے صاف ستھرے طریقے سے حوالہ دینے دیتے ہیں۔

سب سے اہم بات یہ ہے کہ namespaces **Composer autoloading via PSR-4** کے ساتھ مربوط ہیں، جہاں namespace structure directory structure کو عکاس کرتی ہے تاکہ classes خودکار طور پر demand پر لوڈ ہوں — یہ جدید PHP project structure اور dependency management کی بنیاد ہے۔

چونکہ ہر جدید PHP framework، package اور application namespaces کے ساتھ منظم ہے (اور آپ Composer packages کو بغیر انہیں سمجھے استعمال نہیں کر سکتے)، namespaces کو اعلان کرنے، `use` کے ساتھ classes کو import کرنے اور وہ directories کے لیے autoloading کے ساتھ کیسے map کرتے ہیں یہ جاننا جدید PHP development کے لیے بنیادی، روزمرہ کا علم ہے۔

Namespaces، Composer اور PSR-4 autoloading مل کر بتاتے ہیں کہ معاصر PHP projects کیسے ترتیب دیے جاتے ہیں۔