BTS 2 · LE COIN DES RÉVISIONS

PHP

Programmation orientée objet · Les huit chapitres CodeSpirit : classes, relations, héritage, interfaces, traits, enums, hooks et méthodes magiques.

8 fiches

PHP · FICHE DE RÉVISION

6 · Énumérations et valeurs autorisées

Représenter un état, le stocker et traiter correctement une valeur inconnue.

Télécharger la fiche (HTML)

Remplacer les chaînes dispersées

Une enum définit un ensemble fermé de cas nommés (PHP 8.1+). Au lieu de laisser passer « publie », « publié » ou une faute de frappe, un paramètre de type EtatFiche n’accepte qu’un cas de cette enum.

Une enum pure déclare simplement ses cas. Une enum adossée à une valeur (backed enum) associe chaque cas à une valeur unique de type string ou int. Tous les cas de la même enum adossée utilisent le même type.

Utiliser un état dans une classe

php
<?php
declare(strict_types=1);

enum EtatFiche: string
{
    case Brouillon = 'brouillon';
    case Publiee = 'publiee';
    case Archivee = 'archivee';
}

class Fiche
{
    public function __construct(
        public readonly string $titre,
        public EtatFiche $etat = EtatFiche::Brouillon
    ) {}
}

$fiche = new Fiche('Les enums');
$fiche->etat = EtatFiche::Publiee;
echo $fiche->etat->name, PHP_EOL;
echo $fiche->etat->value, PHP_EOL;
echo count(EtatFiche::cases()), PHP_EOL;

name contient le nom PHP du cas ; value contient sa valeur de stockage. cases() liste les cas déclarés. Pour enregistrer l’état en base, utiliser ici $fiche->etat->value ; ce n’est pas l’objet enum entier qu’on transmet au pilote SQL.

from et tryFrom : une différence essentielle

php
<?php
declare(strict_types=1);

enum Etat: string
{
    case Brouillon = 'brouillon';
    case Publie = 'publie';
}

$etat = Etat::tryFrom('inconnu');
echo $etat === null ? 'Etat invalide' : $etat->name;
echo PHP_EOL;

try {
    Etat::from('inconnu');
} catch (ValueError $erreur) {
    echo 'Conversion impossible', PHP_EOL;
}

tryFrom() renvoie le cas correspondant, ou null si la valeur n’existe pas. from() renvoie le cas ou lève une ValueError. Ces deux méthodes n’existent que pour les enums adossées. Un argument de mauvais type peut également provoquer une TypeError : contrôler d’abord la forme des données externes.

Valider sans masquer les erreurs

À retenir

Ne pas transformer silencieusement une saisie inconnue en un état valide si cela change le sens de l’action. Renvoyer une erreur explicite ou appliquer un défaut seulement si le besoin métier le prévoit.

tryFrom("archivee") renvoie-t-il une chaîne ?

Non. Il renvoie le cas EtatFiche::Archivee, un objet de type EtatFiche. Sa propriété value permet de retrouver la chaîne.

Pourquoi une propriété EtatFiche est-elle préférable à string ?

Le type décrit directement les états autorisés. Une chaîne arbitraire ne peut plus être affectée par erreur à cette propriété.