morebec/orkestra-enum

Orkestra component providing enums

v2.5.6 2021-07-05 16:42 UTC

Requires

• php: >=7.4

Requires (Dev)

• ext-dom: *
• friendsofphp/php-cs-fixer: ^2.16
• phpstan/phpstan: ^0.12.7
• phpunit/phpunit: ^9.5
• symfony/var-dumper: 5.*

Apache-2.0

• jwillp

README

This Orkestra component provides typed enumerations to PHP.

Installation

composer require morebec/orkestra-orkestra-enum

Usage

Creating an Enum

To create a new Enum, one needs to extend the Enum class. As an example, lets pretend we want to create a CardinalPoint Class. Since there are strictly 4 cardinal points, this is a good candidate for an Enum:

class CardinalPoint extends Enum
{
    const NORTH = 'NORTH';    
    const EAST = 'EAST';    
    const WEST = 'WEST';  
    const SOUTH = 'SOUTH';
}

Simply doing this, will allow us to use our class in the following way:

// Instantiate a new CardinalPoint instance
$direction = new CardinalPoint(CardinalPoint::NORTH);

// Since Enums have builtin validation,
// the following line would throw an InvalidArgumentException:
$direction = new CardinalPoint('North');

// However the following would work:
$direction = new CardinalPoint('NORTH');

// Using in functions or class methods 
public function changeDirection(CardinalPoint $direction)
{
    // Testing equlity with string
    if(!$direction->isEqualTo(new CardinalPoint(CardinalPoint::EAST))) {
        echo 'Not going East!';
    }

    // Since the constants are strings, it is also possible to compare
    // using loose comparison
    if($direction == CardinalPoint::NORTH) {
        echo 'Definitely going North!';
    }    
}

For easier IDE integration we can even go further adding @method annotations to the Enum class:

/**
* @method static self NORTH() 
* @method static self EAST() 
* @method static self WEST() 
* @method static self SOUTH() 
*/
class CardinalPoint extends Enum
{
   const NORTH = 'NORTH';    
   const EAST = 'EAST';    
   const WEST = 'WEST';  
   const SOUTH = 'SOUTH';
}

This will allow us to do the following in code:

$direction = CardinalPoint::NORTH();

Getting all possible values

In order to get all the possible values as an array you can use the static method getValues:

CardinalPoint::getValues(); 
// Returns an array as: 
// [ 'NORTH', 'EAST', 'WEST', 'SOUTH' ]