PHPerKaigi 2024

Aperçu des énumérations

(PHP 8 >= 8.1.0)

Les énumérations, ou "Enums", permettent à un développeur de définir un type personnalisé qui est limité à l'une des valeurs parmi un nombre discret de valeurs possibles. Cela peut s'avérer particulièrement utile lors de la définition d'un modèle de domaine, car cela permet de "rendre les états non valides irreprésentables".

Les Enums apparaissent dans de nombreux langages avec une variété de caractéristiques différentes. En PHP, les Enums sont un type d'objet particulier. L'Enum lui-même est une classe, et ses cas possibles sont tous des instances distinctes et uniques de cette classe. Cela signifie que les cas d'Enum sont des objets valides et peuvent être utilisés partout où un objet peut être utilisé, y compris pour les vérifications de type.

L'exemple le plus courant d'énumérations est le type booléen intégré, qui est un type énuméré avec les valeurs légales true et false. Les énumérations permettent aux développeurs de définir leurs propres énumérations arbitrairement robustes.

add a note

User Contributed Notes 1 note

up
-6
Hayley Watson
10 months ago
It's important to notice that the description here doesn't describe Enum values as being constants. Some languages, like C, C++, and C#, think of an enum as a list of named integers, and working with enums in those languages is just working with integers. PHP does not do that.

In the same way that PHP's booleans are their own type and not just constants with integer values 1 and 0, an Enum is its own type. It's not a bunch of integers (or strings) that have been given names, and shouldn't be thought of or used as such.

An Enum only needs to be backed by some primitive value like an integer or string if you need to communicate it outside the program (a message, UI, db storage, wire protocol, etc) where it has to be converted from/to its native PHP value (this is addressed again on the Backed Enumerations page). If you're converting back and forth between Enums and their backing values inside your own program to get anything done then you might be missing the point of Enums.

You might want more structure to your Enum than just a pure set of distinct but otherwise nondescript values (you might at least want them to be ordered). But all that carry-on should be encapsulated within the Enum class itself via additional methods.
To Top