Comment fonctionnent les espaces de noms en PHP ?

Question

Accepted Answer

**Les espaces de noms** organisent le code PHP et évitent les **collisions de noms** entre classes, fonctions et constantes — essentiels au fur et à mesure que les applications grandissent et utilisent des packages tiers. Ils fonctionnent comme des répertoires pour les noms de classe et s'intègrent avec l'autoloading Composer (PSR-4).

## Le problème que les espaces de noms résolvent

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

## Déclarer et utiliser les espaces de noms

```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 fichier déclare son `namespace`, et d'autres fichiers `use` (importent) les classes pour s'y référer par nom court. Le nom pleinement qualifié (`\App\Models\User`) est mondialement unique.

## Les espaces de noms se mappent aux répertoires (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).
```

## Importer des fonctions, des constantes et l'espace de noms global

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

## Pourquoi c'est important

Les espaces de noms sont essentiels pour organiser le code PHP moderne et sont fondamentaux pour le fonctionnement de l'ensemble de l'écosystème.

Comprendre leur fonctionnement est important car ils résolvent le problème critique des **collisions de noms** — sans espaces de noms, vos classes entreraient en conflit les unes avec les autres et avec les nombreux packages tiers qu'une application réelle utilise (deux classes `User` ne peuvent pas coexister), ce qui rendrait les grandes applications et les écosystèmes de packages impossibles.

Les espaces de noms donnent à chaque classe un nom pleinement qualifié unique, et les **imports `use`** vous permettent de référencer les classes par des noms courts de manière propre.

Plus important encore, les espaces de noms s'intègrent avec l'**autoloading de Composer via PSR-4**, où la structure des espaces de noms reflète la structure des répertoires afin que les classes soient chargées automatiquement à la demande — c'est le fondement de la structure moderne des projets PHP et de la gestion des dépendances.

Étant donné que chaque framework PHP moderne, package et application sont organisés avec des espaces de noms (et vous ne pouvez pas utiliser les packages Composer sans les comprendre), savoir comment déclarer les espaces de noms, importer les classes avec `use`, et comment ils se mappent aux répertoires pour l'autoloading est une connaissance fondamentale et quotidienne pour tout développement PHP moderne.

Les espaces de noms, Composer et l'autoloading PSR-4 ensemble définissent la structure des projets PHP contemporains.