PHP में namespaces कैसे काम करते हैं?

Question

Accepted Answer

**Namespaces** PHP code को व्यवस्थित करते हैं और classes, functions, और constants के बीच **naming collisions** को रोकते हैं — जैसे-जैसे applications बढ़ते हैं और third-party 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 को declare और उपयोग करना

```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();
    }
}
```

एक file अपना `namespace` declare करती है, और अन्य files classes को short name से संदर्भित करने के लिए उन्हें `use` (import) करती हैं। fully-qualified name (`\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 code को व्यवस्थित करने के लिए आवश्यक हैं और इस बात के लिए मौलिक हैं कि पूरा ecosystem कैसे काम करता है।

इन्हें समझना महत्वपूर्ण है क्योंकि ये **naming collisions** की निर्णायक समस्या को हल करते हैं — namespaces के बिना, आपकी classes एक-दूसरे के साथ और एक वास्तविक application द्वारा उपयोग किए जाने वाले कई third-party packages के साथ टकरातीं (दो `User` classes सह-अस्तित्व में नहीं रह सकतीं), जो बड़े applications और package ecosystems को असंभव बना देता।

Namespaces हर class को एक अद्वितीय fully-qualified name देते हैं, और **`use` imports** आपको classes को short names से साफ़-सुथरे ढंग से संदर्भित करने देते हैं।

सबसे महत्वपूर्ण रूप से, namespaces **PSR-4 के माध्यम से Composer autoloading** के साथ एकीकृत होते हैं, जहाँ namespace structure directory structure को प्रतिबिंबित करता है ताकि classes माँग पर स्वचालित रूप से load हो जाएँ — यह आधुनिक PHP project structure और dependency management की नींव है।

चूँकि हर आधुनिक PHP framework, package, और application namespaces के साथ व्यवस्थित है (और आप namespaces को समझे बिना Composer packages का उपयोग नहीं कर सकते), यह जानना कि namespaces कैसे declare करें, `use` के साथ classes कैसे import करें, और वे autoloading के लिए directories से कैसे map होते हैं, किसी भी आधुनिक PHP development के लिए मौलिक, रोज़मर्रा का ज्ञान है।

Namespaces, Composer, और PSR-4 autoloading मिलकर परिभाषित करते हैं कि समकालीन PHP projects कैसे संरचित होते हैं।