array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'language.types.enumerations.php', 1 => 'Enumerations', 2 => 'Enumerations', ), 'up' => array ( 0 => 'language.types.php', 1 => 'Types', ), 'prev' => array ( 0 => 'language.types.object.php', 1 => 'Objects', ), 'next' => array ( 0 => 'language.types.resource.php', 1 => 'Resources', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'language/types/enumerations.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Enumerations

(PHP 8 >= 8.1.0)

Basic Enumerations

Enumerations are a restricting layer on top of classes and class constants, intended to provide a way to define a closed set of possible values for a type.

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

function do_stuff(Suit $s)
{
// ...
}

do_stuff(Suit::Spades);
?>

For a full discussion, see the Enumerations chapter.

Casting

If an enum is converted to an object, it is not modified. If an enum is converted to an array, an array with a single name key (for Pure enums) or an array with both name and value keys (for Backed enums) is created. All other cast types will result in an error.