Namespaces hufanya kazi vipi katika PHP?

Question

Accepted Answer

**Namespaces** hupanga code ya PHP na kuzuia **naming collisions** kati ya classes, functions, na constants — muhimu kadri applications zinavyokua na kutumia third-party packages. Hufanya kazi kama directories kwa majina ya class, na huunganishwa na Composer autoloading (PSR-4).

## Tatizo ambalo namespaces husuluhisha

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

## Kutangaza na kutumia 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();
    }
}
```

Faili hutangaza `namespace` yake, na faili nyingine `use` (import) classes kuzirejea kwa short name. Fully-qualified name (`\App\Models\User`) ni ya kipekee duniani kote.

## Namespaces hu-map kwa 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).
```

## Kuingiza functions, constants, na 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)
```

## Kwa nini ni muhimu

Namespaces ni muhimu kwa kupanga code ya PHP ya kisasa na ni za msingi kwa jinsi ecosystem nzima inavyofanya kazi.

Kuzielewa ni muhimu kwa sababu husuluhisha tatizo muhimu la **naming collisions** — bila namespaces, classes zako zingegongana zenyewe na na third-party packages nyingi ambazo application halisi hutumia (classes mbili za `User` haziwezi kuishi pamoja), na hivyo kufanya applications kubwa na package ecosystems kuwa haziwezekani.

Namespaces hutoa kila class fully-qualified name ya kipekee, na **`use` imports** hukuwezesha kurejea classes kwa short names kwa usafi.

Muhimu zaidi, namespaces huunganishwa na **Composer autoloading kupitia PSR-4**, ambapo muundo wa namespace huakisi muundo wa directory ili classes zipakiwe kiotomatiki zinapohitajika — huu ndio msingi wa muundo wa modern PHP project na dependency management.

Kwa kuwa kila framework, package, na application ya PHP ya kisasa imepangwa kwa namespaces (na huwezi kutumia Composer packages bila kuzielewa), kujua jinsi ya kutangaza namespaces, kuingiza classes kwa `use`, na jinsi zinavyo-map kwa directories kwa autoloading ni ujuzi wa msingi wa kila siku kwa maendeleo yoyote ya PHP ya kisasa.

Namespaces, Composer, na PSR-4 autoloading kwa pamoja hufafanua jinsi miradi ya PHP ya kisasa inavyopangwa.