Jak fungují namespaces v PHP?

Question

Accepted Answer

**Namespaces** organizují PHP kód a brání **kolizím názvů** mezi třídami, funkcemi a konstantami — to je nezbytné, když aplikace roste a používá balíčky třetích stran. Fungují jako adresáře pro názvy tříd a integrují se s automatickým načítáním Composeru (PSR-4).

## Problém, který řeší 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.
```

## Deklarování a používání 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();
    }
}
```

Soubor deklaruje svůj `namespace` a ostatní soubory používají `use` (import) třídy, aby na ně odkazovaly krátce. Plně kvalifikovaný název (`\App\Models\User`) je globálně jedinečný.

## Namespaces se mapují na adresáře (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).
```

## Import funkcí, konstant a globálního 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)
```

## Proč je to důležité

Namespaces jsou nezbytné pro organizaci moderního PHP kódu a jsou zásadní pro to, jak celý ekosystém funguje.

Jejích pochopení je důležité, protože řeší kritický problém **kolizí názvů** — bez namespaces by vaše třídy kolidovaly spolu navzájem a s mnoha balíčky třetích stran, které skutečná aplikace používá (dvě třídy `User` nemohou existovat vedle sebe), což znemožňuje velké aplikace a ekosystémy balíčků.

Namespaces dávají každé třídě jedinečný plně kvalifikovaný název a **`use` importy** vám umožňují odkazovat na třídy krátkým názvem čistě.

Nejdůležitější je, že se namespaces integrují s **automatickým načítáním Composeru přes PSR-4**, kde struktura namespace zrcadlí strukturu adresářů, takže se třídy načítají automaticky na vyžádání — to je základ moderní struktury PHP projektů a správy závislostí.

Protože je každý moderní PHP framework, balíček a aplikace organizován s namespaces (a nemůžete používat balíčky Composeru bez jejich pochopení), znalost toho, jak deklarovat namespaces, importovat třídy s `use` a jak se mapují na adresáře pro automatické načítání, je základní, každodenní znalost pro libovolný moderní vývoj PHP.

Namespaces, Composer a PSR-4 automatické načítání dohromady definují, jak jsou strukturovány současné PHP projekty.