Kaip veikia vardų sritys (namespaces) PHP?

Question

Accepted Answer

**Vardų sritys (namespaces)** organizuoja PHP kodą ir išvengti **vardų konfliktų** tarp klasių, funkcijų ir konstant — itin svarbu, kai aplikacijos auga ir naudoja trečiųjų šalių paketus. Jos veikia kaip katalogai klasių vardams ir integruojasi su Composer autoloading (PSR-4).

## Problema, kurią sprendžia vardų sritys

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

## Vardų sričių deklaracija ir naudojimas

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

Failas deklaruoja savo `namespace`, o kiti failai `use` (importuoja) klases, kad būtų galima jomis remtis naudojant trumpą vardą. Visas vardas (`\App\Models\User`) yra unikalus globaliai.

## Vardų sritys susiejamos su katalogais (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).
```

## Funkcijų, konstant ir globalios vardų srities importavimas

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

## Kodėl tai svarbu

Vardų sritys yra neatsiejamos dalys modernaus PHP kodo organizavimo ir yra esminės viso ekosistemo funkcionavimui.

Supratimas yra svarbus, nes jos sprendžia kritinę **vardų konfliktų** problemą — be vardų sričių, jūsų klasės konfliktavo viena su kita ir su daugybe trečiųjų šalių paketų, kuriuos naudoja reali aplikacija (dvi `User` klasės negali egzistuoti vienu metu), dėl ko didelės aplikacijos ir paketų ekosistema būtų neįmanoma.

Vardų sritys suteikia kiekvienai klasei unikalų visą vardą, ir **`use` importai** leidžia jomis remtis naudojant trumpus vardus gražiai.

Svarbiausias dalykas yra tai, kad vardų sritys integruojasi su **Composer autoloading per PSR-4**, kur vardų srities struktūra atspindi katalogo struktūrą, todėl klasės automatiškai įkeliamos reikiamos metu — tai yra šiuolaikinio PHP projekto struktūros ir priklausomybių valdymo pagrindas.

Kadangi kiekvienas šiuolaikinis PHP framework, paketas ir aplikacija yra organizuota su vardų sritimis (ir jūs negali naudoti Composer paketų jos nesuprasdami), žinojimas kaip deklaruoti vardų sritis, importuoti klases su `use` ir kaip jos susiejamos su katalogais autoloading yra pagrindinis, kasdieninis žinojimas bet kuriam šiuolaikiniam PHP vystymuisi.

Vardų sritys, Composer ir PSR-4 autoloading kartu apibrėžia, kaip yra suorganizuoti šiuolaikiniai PHP projektai.