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.

    Found A Problem?

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

    User Contributed Notes 1 note

    up
    50
    esdras-schonevald
    3 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