BackedEnum
PHP Manual

BackedEnum::from

Maps a scalar to an enum instance

Description

public static static BackedEnum::from(intstring $value)

The from method translates a string or int into the corresponding Enum case, if any. If there is no matching case defined, it will throw a ValueError.

Parameters

value

The scalar value to map to an enum case.

Return Values

A case instance of this enumeration.

Examples

Example #1 Basic usage

The following example illustrates how enum cases are returned. 

<?php
enum Suit: string
{
    case Hearts = 'H';
    case Diamonds = 'D';
    case Clubs = 'C';
    case Spades = 'S';
}

$h = Suit::from('H');

var_dump($h);

$b = Suit::from('B');
?>

The above example will output:

enum(Suit::Hearts)

Fatal error: Uncaught ValueError: "B" is not a valid backing value for enum "Suit" in /file.php:15

See Also

  • UnitEnum::cases
  • BackedEnum::tryFrom