Forum PHP 2025

UnitEnum::cases

(PHP 8 >= 8.1.0)

UnitEnum::casesGénère une liste de cas sur une énumération

Description

public static UnitEnum::cases(): array

Cette méthode retourne un tableau de tous les cas d'une énumération, dans l'ordre de leur déclaration.

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Valeurs de retour

Un tableau de tous les cas définis de cette énumération, dans l'ordre de la déclaration.

Exemples

Exemple #1 Utilisation de base

L'exemple suivant illustre la façon dont les cas d'énumération sont retournés.

<?php
enum Suit
{
case
Hearts;
case
Diamonds;
case
Clubs;
case
Spades;
}

var_dump(Suit::cases());
?>

L'exemple ci-dessus va afficher :

array(4) {
    [0]=>
    enum(Suit::Hearts)
    [1]=>
    enum(Suit::Diamonds)
    [2]=>
    enum(Suit::Clubs)
    [3]=>
    enum(Suit::Spades)
}
add a note

User Contributed Notes 2 notes

up
60
avishkasenanayake at hotmail dot com
2 years ago
If anyone is here wondering how to get all the names from the enum cases and map them into an array, it can be done like this:

array_column(CampaignPeriods::cases(), 'name');

Likewise, have the 2nd argument as 'value' to get the enum's values.

Happy coding, web artisan :)
up
0
miken32 at example dot com
3 days ago
The Enum documentation says, "if a Backed Enum is serialized to JSON, it will be represented by its scalar value only, in the appropriate type."

This means you can easily get a backed Enum's values for use in a JSON document using only the BackedEnum::cases() method:

<?php
enum Suits: string {
case
Hearts = 'Heart';
case
Diamonds = 'Diamond';
case
Clubs = 'Spade';
case
Spades = 'Club';
}
echo
json_encode(Suits::cases());
?>

Results in this output:

["Heart","Diamond","Spade","Club"]
To Top