Introduction aux Traits

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

PHP ne supporte que l'héritage simple - une classe ne peut étendre qu'une seule classe parente. Mais que se passe-t-il si vous avez besoin de partager des fonctionnalités entre plusieurs classes non liées ? C'est là que les traits interviennent.

Un trait est un mécanisme de réutilisation de code qui vous permet de définir des méthodes et des propriétés pouvant être insérées dans plusieurs classes. Considérez les traits comme un copier-coller au niveau du langage - le code d'un trait fait partie de la classe qui l'utilise.

<?php
trait Timestampable {
    private string $createdAt;
    
    public function setCreatedAt(): void {
        $this->createdAt = date('Y-m-d H:i:s');
    }
    
    public function getCreatedAt(): string {
        return $this->createdAt;
    }
}

class Article {
    use Timestampable;
    
    public function __construct(public string $title) {
        $this->setCreatedAt();
    }
}

$article = new Article("PHP Traits");
echo $article->getCreatedAt();

Le mot-clé use à l'intérieur d'une classe importe les membres du trait. Désormais, Article a accès à setCreatedAt() et getCreatedAt() comme s'ils étaient définis directement dans la classe.

Le même trait peut être utilisé dans des classes totalement indépendantes - une classe Comment, une classe User, ou toute autre classe nécessitant une fonctionnalité d'horodatage. Cela résout la limitation de l'héritage simple en permettant le partage horizontal de code à travers votre hiérarchie de classes.

Défi

Facile

Construisons un système de salutation simple qui démontre comment les traits vous permettent de partager des fonctionnalités entre des classes non liées. Vous allez créer un trait qui fournit une capacité de salutation, puis l'utiliser dans deux classes complètement différentes.

Vous organiserez votre code sur trois fichiers :

Greetable.php — Créez un trait appelé Greetable qui fournit une fonctionnalité de salutation. Le trait doit avoir :
- Une propriété privée $greeting (string)
- Une méthode setGreeting(string $greeting) qui stocke le message de salutation
- Une méthode greet() qui retourne le message de salutation
Person.php — Créez une classe Person qui utilise le trait Greetable. Incluez le fichier du trait et utilisez la promotion de constructeur pour définir une propriété publique $name. Dans le constructeur, appelez setGreeting() pour définir la salutation à "Hello, I'm [name]".
Robot.php — Créez une classe Robot qui utilise également le trait Greetable. Incluez le fichier du trait et utilisez la promotion de constructeur pour définir une propriété publique $model. Dans le constructeur, appelez setGreeting() pour définir la salutation à "Beep boop, I am model [model]".

Dans main.php, incluez les deux fichiers de classe. Vous recevrez deux entrées : le nom d'une personne et le numéro de modèle d'un robot. Créez des instances des deux classes et affichez leurs salutations sur des lignes séparées.

Cela démontre la puissance des traits — Person et Robot sont des classes complètement indépendantes sans parent commun, pourtant elles bénéficient toutes deux de la même fonctionnalité de salutation via le trait. Chaque classe personnalise la manière dont elle utilise cette fonctionnalité à sa façon.

Aide-mémoire

Un trait est un mécanisme de réutilisation de code qui vous permet de partager des méthodes et des propriétés entre plusieurs classes non liées, résolvant ainsi la limitation de l'héritage simple de PHP.

Définissez un trait en utilisant le mot-clé trait :

<?php
trait Timestampable {
    private string $createdAt;
    
    public function setCreatedAt(): void {
        $this->createdAt = date('Y-m-d H:i:s');
    }
    
    public function getCreatedAt(): string {
        return $this->createdAt;
    }
}

Utilisez un trait dans une classe avec le mot-clé use :

class Article {
    use Timestampable;
    
    public function __construct(public string $title) {
        $this->setCreatedAt();
    }
}

Les méthodes et propriétés du trait font partie de la classe comme si elles y étaient définies directement. Plusieurs classes non liées peuvent utiliser le même trait pour partager des fonctionnalités horizontalement à travers votre hiérarchie de classes.

Essayez vous-même

<?php

require_once 'Person.php';
require_once 'Robot.php';

// Lire l'entrée
$name = trim(fgets(STDIN));
$model = trim(fgets(STDIN));

// TODO: Créer une instance de Person avec le nom donné
// TODO: Créer une instance de Robot avec le modèle donné
// TODO: Afficher la salutation de la Personne
// TODO: Afficher la salutation du Robot (sur une nouvelle ligne)

?>