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 prennent de l’ampleur, vous créerez de nombreuses classes. Que se passe-t-il lorsque deux classes portent 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 à l’aide du mot-clé namespace :

<?php
namespace Blog;

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

Vous pouvez maintenant 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 avec espace de noms, vous la référencez à l’aide de 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

La barre oblique inverse \ sépare les niveaux d’espace de noms, de manière similaire aux barres obliques qui 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 noms et permettent de garder 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 à l'aide d'espaces de noms afin d'é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 possèdent 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 donnent ce nom à leurs chats !).

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: [brand]".
Animal/Car.php : définissez une classe Car dans l'espace de noms Animal (il s'agit d'un chat nommé Car !). Elle doit posséder 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: [age]".
main.php : incluez les deux fichiers de classes à l'aide de require_once. Créez un objet de chaque espace de noms en utilisant leurs chemins complets, puis affichez le résultat de l'appel de describe() sur chaque objet (chacun sur sa propre ligne).

Dans main.php, créez :

un Vehicle\Car avec la marque "Toyota"
un Animal\Car âgé de 3 ans

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

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 du namespace avec le backslash

// TODO: Créer un objet Animal\Car avec l'âge 3
// N'oubliez pas d'utiliser le chemin complet du namespace avec le backslash

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

?>