Kako funkcioniraju imenski prostori (namespaces) u PHP-u?

Question

Accepted Answer

**Imenski prostori** organiziraju PHP kod i sprječavaju **kolizije imena** između klasa, funkcija i konstanti — bitne su kako aplikacije rastu i koriste pakete trećih strana. Funkcioniraju kao direktoriji za imena klasa i integrirane su s Composer autoloadingom (PSR-4).

## Problem koji imenski prostori rješavaju

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

## Deklariranje i korištenje imenskih prostora

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

Datoteka deklarira svoj `namespace`, a druge datoteke `use` (uvozom) klase kako bi ih referencirale prema kratkom imena. U potpunosti kvalificirano ime (`\App\Models\User`) je globalno jedinstveno.

## Imenski prostori se mapiraju direktorijima (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).
```

## Uvozenje funkcija, konstanti i globalnog imenskog prostora

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

## Zašto je to važno

Imenski prostori su bitni za organizaciju modernog PHP koda i temeljni su za način na koji cijeli ekosustav funkcionira.

Razumijevanje njih je važno jer rješavaju kritičan problem **kolizija imena** — bez imenskih prostora, vaše klase bi se sukobljavale međusobno i s mnogim paketima trećih strana koje prava aplikacija koristi (dvije klase `User` ne mogu koegzistirati), što čini velike aplikacije i ekosustave paketa nemoguće.

Imenski prostori daju svakoj klasi jedinstveno potpuno kvalificirano ime, a **`use` uvozimo** vam omogućavaju da referencirati klase prema kratkim imenima čisto.

Najvažnije, imenski prostori se integriraju s **Composer autoloadingom putem PSR-4**, gdje struktura imenskog prostora zrcali strukturu direktorija tako da se klase automatski učitavaju na zahtjev — ovo je temelj moderne strukture PHP projekta i upravljanja ovisnostima.

Budući da je svaki moderni PHP okvir, paket i aplikacija organiziran s imenskim prostorima (i ne možete koristiti Composer pakete bez razumijevanja njih), znanje kako deklarirati imenskog prostora, uvoziti klase s `use` i kako se mapiraju direktorijima za autoloading je temeljno, svakodnevno znanje za bilo koji moderni PHP razvoj.

Imenski prostori, Composer i PSR-4 autoloading zajedno određuju kako su suvremeni PHP projekti strukturirani.