Chapprend · BTS 2 · PHP

5 · Traits et réutilisation de code

Partager un comportement, initialiser son état et résoudre les conflits de méthodes.

Un outil de réutilisation, pas un type

Un trait rassemble des méthodes et éventuellement des propriétés à réutiliser dans plusieurs classes. On l’insère avec use à l’intérieur de la classe. On ne peut ni instancier un trait avec new, ni l’utiliser comme un contrat de type à la place d’une interface.

Une classe peut utiliser plusieurs traits. Cela ne crée pas plusieurs classes parentes : l’héritage de classe reste simple. Éviter les traits qui dépendent discrètement de nombreuses propriétés de leurs hôtes ; leurs prérequis deviennent difficiles à comprendre.

Exemple : marquer une mise à jour

php
<?php
declare(strict_types=1);

trait Horodatable
{
    private ?DateTimeImmutable $modifieLe = null;

    public function marquerModification(DateTimeImmutable $date): void
    {
        $this->modifieLe = $date;
    }

    public function derniereModification(): string
    {
        return $this->modifieLe?->format('Y-m-d') ?? 'Jamais';
    }
}

class Fiche
{
    use Horodatable;
}

class Quiz
{
    use Horodatable;
}

$fiche = new Fiche();
$quiz = new Quiz();
$fiche->marquerModification(new DateTimeImmutable('2026-10-08'));
echo $fiche->derniereModification(), PHP_EOL;
echo $quiz->derniereModification(), PHP_EOL;

Le trait initialise explicitement son état à null, donc une lecture avant modification est prévue. Chaque objet possède sa propre date : modifier la fiche ne modifie pas le quiz. DateTimeImmutable évite de modifier une date partagée par surprise.

Priorité et conflits

Une méthode définie dans la classe prend le dessus sur celle du trait ; celle du trait prend le dessus sur une méthode héritée. Si deux traits fournissent une méthode de même nom, le conflit doit être résolu explicitement.

php
<?php
declare(strict_types=1);

trait FormatCourt
{
    public function format(): string { return 'court'; }
}

trait FormatLong
{
    public function format(): string { return 'long'; }
}

class Rapport
{
    use FormatCourt, FormatLong {
        FormatCourt::format insteadof FormatLong;
        FormatLong::format as formatDetaille;
    }
}

$rapport = new Rapport();
echo $rapport->format(), ' / ', $rapport->formatDetaille(), PHP_EOL;

insteadof choisit l’implémentation utilisée pour le nom en conflit. as crée un alias : il ne supprime pas la méthode originale et ne résout pas seul tous les conflits.

Vérifier son choix

Peut-on écrire function enregistrer(Horodatable $objet) pour exiger le trait ?

Non : un trait ne définit pas un type utilisable comme une interface. Déclarer une interface avec les méthodes requises et la faire implémenter par les classes concernées.

À retenir

Interface = contrat ; héritage = spécialisation ; trait = code partagé. Choisir selon le besoin, pas uniquement pour économiser quelques lignes.