Introduction aux espaces de noms

Fait partie de la section Programmation Orientée Objet du Journey PHP de Coddy — leçon 10 sur 91.

À mesure que vos projets PHP se développent, vous créerez de nombreuses classes. Que se passe-t-il lorsque deux classes ont le même nom ?

Par exemple, vous pourriez avoir une classe User pour votre blog et une autre classe User pour votre boutique. Les espaces de noms résolvent ce problème en organisant les classes en groupes logiques.

Un espace de noms est comme un dossier pour vos classes. Vous le déclarez en haut de votre fichier PHP en utilisant le mot-clé namespace :

<?php
namespace Blog;

class User {
    public $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
}

Maintenant, vous pouvez avoir une autre classe User dans un espace de noms différent :

<?php
namespace Shop;

class User {
    public $email;
    
    public function __construct($email) {
        $this->email = $email;
    }
}

Pour utiliser une classe d'un espace de noms, vous la référencez avec son chemin complet en utilisant une barre oblique inverse :

<?php
$blogUser = new \Blog\User("Alice");
$shopUser = new \Shop\User("alice@example.com");

echo $blogUser->name . "\n";
echo $shopUser->email . "\n";

Sortie :

Alice
alice@example.com

L'antislash \ sépare les niveaux d'espace de noms, tout comme les barres obliques séparent les dossiers dans un chemin de fichier. Vous pouvez également créer des espaces de noms imbriqués comme App\Models\Blog pour une organisation plus approfondie.

Point clé : Les espaces de noms évitent les conflits de nommage et maintiennent votre code organisé. Déclarez toujours l'espace de noms avant tout autre code dans votre fichier (à l'exception des instructions declare).

Défi

Facile

Organisons une petite application en utilisant des espaces de noms (namespaces) pour éviter les conflits de noms entre des classes portant le même nom.

Imaginez que vous construisez un système qui gère à la fois des véhicules et des animaux. Les deux domaines ont une entité appelée Car — l'une représente une véritable automobile, tandis que l'autre est un chat domestique nommé "Car" (oui, certaines personnes nomment leurs chats ainsi !).

Vous allez créer trois fichiers :

Vehicle/Car.php — Définissez une classe Car dans l'espace de noms Vehicle avec une propriété public $brand. Le constructeur doit accepter le nom de la marque et le définir. Ajoutez une méthode describe() qui retourne "Vehicle: " . $this->brand.
Animal/Car.php — Définissez une classe Car dans l'espace de noms Animal (c'est un chat nommé Car !). Elle doit avoir une propriété public $age. Le constructeur accepte l'âge et le définit. Ajoutez une méthode describe() qui retourne "Cat named Car, age: " . $this->age.
main.php — Incluez les deux fichiers de classe en utilisant require_once. Créez un objet de chaque espace de noms en utilisant leurs chemins d'espace de noms complets, puis affichez le résultat de l'appel à describe() sur chaque objet (chacun sur sa propre ligne).

Dans main.php, créez :

Un Vehicle\Car avec la marque "Toyota"
Un Animal\Car avec l'âge 3

N'oubliez pas d'utiliser l'antislash \ pour référencer les classes avec espace de noms par leur chemin complet lors de la création des objets.

Aide-mémoire

Les espaces de noms (namespaces) organisent les classes en groupes logiques et évitent les conflits de nommage lorsque plusieurs classes partagent le même nom.

Déclarez un espace de noms en haut d'un fichier PHP en utilisant le mot-clé namespace :

<?php
namespace Blog;

class User {
    public $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
}

Vous pouvez avoir des classes portant le même nom dans différents espaces de noms :

<?php
namespace Shop;

class User {
    public $email;
    
    public function __construct($email) {
        $this->email = $email;
    }
}

Pour utiliser une classe appartenant à un espace de noms, référencez-la avec son chemin complet en utilisant un antislash \ :

<?php
$blogUser = new \Blog\User("Alice");
$shopUser = new \Shop\User("alice@example.com");

echo $blogUser->name . "\n";
echo $shopUser->email . "\n";

L'antislash sépare les niveaux d'espace de noms, de la même manière que les chemins de dossiers. Vous pouvez créer des espaces de noms imbriqués comme App\Models\Blog.

Important : Déclarez toujours l'espace de noms avant tout autre code dans votre fichier (à l'exception des instructions declare).

Essayez vous-même

<?php
// Inclure les fichiers de classe
require_once 'Vehicle/Car.php';
require_once 'Animal/Car.php';

// TODO : Créer un objet Vehicle\Car avec la marque "Toyota"
// N'oubliez pas d'utiliser le chemin complet de l'espace de noms avec un antislash

// TODO : Créer un objet Animal\Car avec l'âge 3
// N'oubliez pas d'utiliser le chemin complet de l'espace de noms avec un antislash

// TODO : Afficher le résultat de describe() pour chaque objet (chacun sur sa propre ligne)

?>