Hogyan működnek a névterek a PHP-ben?

Question

Accepted Answer

**Névterek** szervezik a PHP kódot és megakadályozzák az **elnevezési ütközéseket** osztályok, függvények és konstansok között — elengedhetetlenek az alkalmazások növekedése és harmadik féltől származó csomagok használata során. Úgy működnek, mint könyvtárak az osztálynevekhez, és integrálódnak a Composer autoloading-gal (PSR-4).

## A problémát, amelyet a névterek megoldanak

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

## Névterek deklarálása és használata

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

Egy fájl deklarálja a `namespace`-et, és más fájlok `use` (importálnak) osztályokat, hogy rövidített névvel hivatkozhassanak rájuk. A teljesen minősített név (`\App\Models\User`) globálisan egyedi.

## Névterek leképezése könyvtárakra (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).
```

## Függvények, konstansok és a globális névtér importálása

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

## Miért fontos

A névterek elengedhetetlenek a modern PHP kód szervezéséhez, és alapvetőek az egész ökoszisztéma működésében.

Fontos megérteni őket, mert megoldják az **elnevezési ütközések** kritikus problémáját — névterek nélkül az osztályaid ütköznének egymással és a valós alkalmazások által használt számos harmadik féltől származó csomaggal (két `User` osztály nem létezhetnék egyszerre), ami lehetetlen teszi nagy alkalmazások és csomagökoszisztémák létrehozását.

A névterek minden osztálynak egyedi teljesen minősített nevet adnak, és az **`use` importok** lehetővé teszik, hogy az osztályokat rövidített nevek alapján tisztán referenciáld.

A legfontosabb, hogy a névterek integrálódnak a **Composer autoloading-gal PSR-4 segítségével**, ahol a névtér szerkezete tükrözi a könyvtár szerkezetét, így az osztályok automatikusan igény szerint betöltődnek — ez a modern PHP projekt szerkezet és függőségkezelés alapja.

Mivel minden modern PHP keretrendszer, csomag és alkalmazás névterekkel van szervezve (és nem használhatsz Composer csomagokat anélkül, hogy megértenéd őket), a névterek deklarálása, az osztályok `use`-zal való importálása és a könyvtári szerkezetre való leképezésük az autoloading-hoz szükséges tudás alapvető, mindennapi ismeret minden modern PHP fejlesztőnek.

A névterek, a Composer és a PSR-4 autoloading együttesen definiálják, hogyan épülnek fel az esetleges PHP projektek.