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.

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    3
    esdras-schonevald
    2 years ago
    https://gist.github.com/esdras-schonevald/71a6730e6191c5e9c053e2f65b839eec

    <?php

    declare(strict_types=1);

    /**
    * This is a sample
    * How to use Enum to create a custom exception cases
    * PHP 8.1^
    */

    enum MyExceptionCase {
    case     InvalidMethod;
    case     InvalidProperty;
    case     Timeout;
    }

    class     MyException extends Exception {
    function     __construct(private MyExceptionCase $case){
    match(    $case){
    MyExceptionCase::InvalidMethod => parent::__construct("Bad Request - Invalid Method", 400),
    MyExceptionCase::InvalidProperty => parent::__construct("Bad Request - Invalid Property", 400),
    MyExceptionCase::Timeout => parent::__construct("Bad Request - Timeout", 400)
    };
    }
    }

    // Testing my custom exception class
    try {
    throw new     MyException(MyExceptionCase::InvalidMethod);
    } catch (    MyException $myE) {
    echo     $myE->getMessage(); // Bad Request - Invalid Method
    }
    ＋add a note
    To Top