PHP मा namespaces कसरी काम गर्छन्?

Question

Accepted Answer

**Namespaces** ले PHP कोड संगठित गर्छ र **naming collisions** (classes, functions, र constants बीच नाम टकराएको समस्या) रोक्छ — यो अपरिहार्य छ जब अनुप्रयोगहरू बढ्छन् र third-party packages प्रयोग गर्छन्। तिनीहरू class नामहरूको लागि 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` घोषणा गर्छ, र अन्य फाइलहरूले `use` (import) गरेर classes लाई छोटो नामले सन्दर्भ गर्छन्। पूर्ण रूपमा योग्य नाम (`\App\Models\User`) विश्वव्यापी अद्वितीय छ।

## Namespaces directories मा म्यापिङ्ग हुन्छ (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 को आयात

```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 एकअर्कासँग र वास्तविक अनुप्रयोगले प्रयोग गरेको धेरै third-party packages सँग टकराएको हुन्थ्यो (दुई `User` classes एकै पल सह-अस्तित्वमा हुन सक्दैनन्), जसले ठूला अनुप्रयोग र package ecosystems असम्भव बनाउँछ।

Namespaces ले प्रत्येक class लाई अद्वितीय पूर्ण-योग्य नाम दिन्छ, र **`use` imports** ले तपाईंलाई classes लाई साफसुथरो तरिकाले छोटो नामहरूद्वारा सन्दर्भ गर्न दिन्छ।

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

प्रत्येक आधुनिक PHP framework, package, र अनुप्रयोग namespaces (र तपाई Composer packages प्रयोग बिना तिनीहरू बुझ्न सक्नुहुन्न) सँग संगठित भएको हुनाले, namespace घोषणा गर्न, `use` सँग classes आयात गर्न, र autoloading को लागि directories मा कसरी म्यापिङ्ग हुन्छ भन्ने कुरा जान्न कुनै पनि आधुनिक PHP development को लागि मौलिक, दैनिक ज्ञान हो।

Namespaces, Composer, र PSR-4 autoloading सँगसँगै समकालीन PHP projects को संरचना परिभाषित गर्छन्।