Forum PHP 2025

UnitEnum::cases

(PHP 8 >= 8.1.0)

UnitEnum::casesGenerates a list of cases on an enum

Description

public static UnitEnum::cases(): array

This method will return a packed array of all cases in an enumeration, in order of declaration.

Parameters

This function has no parameters.

Return Values

An array of all defined cases of this enumeration, in order of declaration.

Examples

Example #1 Basic usage

The following example illustrates how enum cases are returned.

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

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

The above example will output:

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