Come funzionano gli spazi dei nomi (namespace) in PHP?

Question

Accepted Answer

**Gli spazi dei nomi (namespace)** organizzano il codice PHP e prevengono **collisioni di nomi** tra classi, funzioni e costanti — essenziali man mano che le applicazioni crescono e utilizzano pacchetti di terze parti. Funzionano come directory per i nomi delle classi e si integrano con l'autoloading di Composer (PSR-4).

## Il problema che gli spazi dei nomi risolvono

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

## Dichiarare e utilizzare gli spazi dei nomi

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

Un file dichiara il suo `namespace`, e altri file `use` (importano) classi per fare riferimento a esse con nome breve. Il nome completo (`\App\Models\User`) è globalmente univoco.

## Gli spazi dei nomi si mappano alle directory (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).
```

## Importare funzioni, costanti e lo spazio dei nomi globale

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

## Perché è importante

Gli spazi dei nomi sono essenziali per organizzare il codice PHP moderno e sono fondamentali per il funzionamento dell'intero ecosistema.

Capirli è importante perché risolvono il problema critico delle **collisioni di nomi** — senza spazi dei nomi, le tue classi entrerebbero in conflitto tra loro e con i molti pacchetti di terze parti che un'applicazione reale usa (due classi `User` non possono coesistere), rendendo impossibili le grandi applicazioni e gli ecosistemi di pacchetti.

Gli spazi dei nomi assegnano a ogni classe un nome completo univoco, e gli **`use` import** ti permettono di fare riferimento alle classi con nomi brevi in modo pulito.

Ma soprattutto, gli spazi dei nomi si integrano con l'**autoloading di Composer tramite PSR-4**, dove la struttura dello spazio dei nomi riflette la struttura delle directory in modo che le classi vengano caricate automaticamente on demand — questa è la base della struttura del progetto PHP moderno e della gestione delle dipendenze.

Poiché ogni framework PHP moderno, pacchetto e applicazione è organizzato con spazi dei nomi (e non puoi usare pacchetti Composer senza capirli), sapere come dichiarare spazi dei nomi, importare classi con `use` e come si mappano alle directory per l'autoloading è una conoscenza fondamentale e quotidiana per qualsiasi sviluppo PHP moderno.

Gli spazi dei nomi, Composer e l'autoloading PSR-4 insieme definiscono come i progetti PHP contemporanei sono strutturati.