tebru/enum

Simple enum library for PHP

v0.5.0 2017-02-03 19:41 UTC

This package is auto-updated.

Last update: 2024-11-24 12:03:33 UTC


README

Build Status Code Coverage Scrutinizer Code Quality SensioLabsInsight

Enum

A simple PHP library to add support for enums. This requires slightly more work than myclabs/php-enum, but does not require reflection. It also forces enums to be singletons.

Installation

composer require tebru/enum

Usage

To use, extend AbstractEnum and implement the getConstants() method.

class DirectionEnum extends AbstractEnum
{
    const NORTH = 'north';
    const EAST = 'east';
    const SOUTH = 'south';
    const WEST = 'west';

    /**
     * Return an array of enum class constants
     *
     * @return array
     */
    public static function getConstants()
    {
        return [
            self::NORTH,
            self::EAST,
            self::SOUTH,
            self::WEST,
        ];
    }
}

Now you can create a new instance using the static method.

DirectionEnum::create('north');

You can also create an instance using the __callStatic magic method.

DirectionEnum::NORTH();

Add a hint to the enum doc block

/**
 * @method static $this NORTH()
 */

Reference

There are multiple methods available on each enum

  • create() [static] Returns an instance of the enum
  • values() [static] A 0-indexed array of all of the enum values
  • exists($value) [static] Returns true if the value exists
  • toArray() [static] Returns a hash with keys and values as the enum values
  • equals($enum) Performs a strict comparison of two enum values
  • getValue() Returns the current value of the enum
  • __toString() Same as getValue()