macrominds/enum

A simple enum implementation for php that allows for typehinting.

A simple enum implementation for php that allows for typehinting.

, _(*1)

Usage

Example

In order to create a blazingly simple Salutation enum, just create it as follows:, _(*2)

use macrominds\enum\Enumerations;


class Salutation
{
    use Enumerations;
    protected static $enums = [
            'MRS' => 1,
            'MR' => 2,
            'MS' => 3
        ];
}

If you require complex epressions for your enum values, just take the alternative static method approach and you're fine., _(*3)

//alternative approach

use macrominds\enum\Enumerations;

class AnyValueEnum
{
    use Enumerations;

    protected static function enums(){
        return [
            'String' => 'string',
            'Integer' => 2,
            'Object' => Salutation::MR()
        ];
    }
}

That's it. You are now able to typehint your functions and you're sure that you get instances of your custom enum. See tests/EnumTest.php if you're in doubt. It shows which expectations you can make., _(*4)

// example for type hinted function
public function save(Salutation $salutation) {
    saveToDB($salutation->value());
}

// example for fetching the enum from value
public function load($value) {
    // throws \Exception if $value is invalid
    return Salutation::fromValue($value);
}

// example for fetching the enum from key
public function loadKey($key) {
    // throws \Exception if $key is invalid
    return Salutation::fromKey($key);
}

IDE Support

In order to support code completion, you may want to give hints about the resulting methods:, _(*5)

use macrominds\enum\Enumerations;

/**
 * @method static \macrominds\enum\Salutation MRS()
 * @method static \macrominds\enum\Salutation MR()
 * @method static \macrominds\enum\Salutation MS()
 */
class Salutation
{
    use Enumerations;
    protected static $enums = [
            'MRS' => 1,
            'MR' => 2,
            'MS' => 3
        ];
}

Installation

composer require macrominds/enum., _(*6)

TODO

• More source documentation.
• Make sure that configured names and values are unique: This is currently the developer's responsibility when creating a custom Enum.
• Make php5.6 compatible