PHP Enum Enhancements

A Composer package for PHP that adds some helpful enum traits to the glorious new PHP Enum type.

The package so far provides;

• A handy trait that extends PHP's native Enum type
• Adds a new static valueArray(): array method that returns all values within an Enum as an equally typed array of Enum values
• Adds a new static valueList(string $separator = ', '): string method that returns all values within an Enum as a comma separated list string

The package is available on Packagist as othyn/php-enum-enhancements.

---

Installation

Hop into your project that you wish to install it in and run the following Composer command to grab the latest version:

composer require othyn/php-enum-enhancements

---

Usage

For more comprehensive usage examples, you can view the test suite. However I'll show some basic usage examples below.

Enum: Value Array

<?php

namespace App\Enums;

use Othyn\PhpEnumEnhancements\Traits\EnumEnhancements;

enum TestEnum
{
    use EnumEnhancements;

    case Alpha;
    case Bravo;
    case Charlie;
    case Delta;
    case Echo;
}

print_r(TestEnum::valueArray());

// Results in the following being printed:
// Array
// (
//     [0] => Alpha
//     [1] => Bravo
//     [2] => Charlie
//     [3] => Delta
//     [4] => Echo
// )

Enum: Value List

<?php

namespace App\Enums;

use Othyn\PhpEnumEnhancements\Traits\EnumEnhancements;

enum TestEnum
{
    use EnumEnhancements;

    case Alpha;
    case Bravo;
    case Charlie;
    case Delta;
    case Echo;
}

print_r(TestEnum::valueList());

// Results in the following being printed:
// 'Alpha, Bravo, Charlie, Delta, Echo'

print_r(TestEnum::valueList(separator: ':'));

// Results in the following being printed:
// 'Alpha:Bravo:Charlie:Delta:Echo'

Backed String Enum: Value Array

<?php

namespace App\Enums;

use Othyn\PhpEnumEnhancements\Traits\EnumEnhancements;

enum TestStringBackedEnum: string
{
    use EnumEnhancements;

    case Alpha   = 'alpha';
    case Bravo   = 'bravo';
    case Charlie = 'charlie';
    case Delta   = 'delta';
    case Echo    = 'echo';
}

print_r(TestStringBackedEnum::valueArray());

// Results in the following being printed:
// Array
// (
//     [0] => alpha
//     [1] => bravo
//     [2] => charlie
//     [3] => delta
//     [4] => echo
// )

Backed String Enum: Value List

<?php

namespace App\Enums;

use Othyn\PhpEnumEnhancements\Traits\EnumEnhancements;

enum TestStringBackedEnum: string
{
    use EnumEnhancements;

    case Alpha   = 'alpha';
    case Bravo   = 'bravo';
    case Charlie = 'charlie';
    case Delta   = 'delta';
    case Echo    = 'echo';
}

print_r(TestStringBackedEnum::valueList());

// Results in the following being printed:
// 'alpha, bravo, charlie, delta, echo'

print_r(TestStringBackedEnum::valueList(separator: ':'));

// Results in the following being printed:
// 'alpha:bravo:charlie:delta:echo'

Backed Int Enum: Value Array

<?php

namespace App\Enums;

use Othyn\PhpEnumEnhancements\Traits\EnumEnhancements;

enum TestIntBackedEnum: int
{
    use EnumEnhancements;

    case One   = 1;
    case Two   = 2;
    case Three = 3;
    case Four  = 4;
    case Five  = 5;
}

print_r(TestIntBackedEnum::valueArray());

// Results in the following being printed:
// Array
// (
//     [0] => 1
//     [1] => 2
//     [2] => 3
//     [3] => 4
//     [4] => 5
// )

Backed Int Enum: Value List

<?php

namespace App\Enums;

use Othyn\PhpEnumEnhancements\Traits\EnumEnhancements;

enum TestIntBackedEnum: int
{
    use EnumEnhancements;

    case One   = 1;
    case Two   = 2;
    case Three = 3;
    case Four  = 4;
    case Five  = 5;
}

print_r(TestIntBackedEnum::valueList());

// Results in the following being printed:
// '1, 2, 3, 4, 5'

print_r(TestIntBackedEnum::valueList(separator: ':'));

// Results in the following being printed:
// '1:2:3:4:5'

---

Development

Most development processes are wrapped up in an easy to use Docker container.

Enforcing Style

The projects .php-cs-fixer.dist.php config contains the rules that this repo conforms to and will run against the ./src and ./tests directory.

For remote style enforcement there is a GitHub Action configured to automatically run phpcsfixer.

For local style enforcement there is a composer script composer style configured to run phpcsfixer.

Testing

For remote testing there is a GitHub Action setup to automatically run the test suite on the main branch or and PR branches.

For local testing there is a Docker container that is pre-built that contains an Alpine CLI release of PHP + PHPUnit + xdebug. This is setup to test the project and can be setup via the following:

composer docker-build

This should trigger Docker Compose to build the image. You can then up the container via the following:

composer docker-up

There are tests for all code written, in which can be run via:

# PHPUnit with code coverage report
composer test

# PHPUnit with code coverage report, using local phpunit and xdebug
composer test-local

In those tests, there are Feature tests for a production ready implementation of the package. There are no Unit tests at present.

You can also easily open a shell in the testing container by using the command:

composer docker-shell

---

Changelog

Any and all project changes for releases should be documented below. Versioning follows the SEMVER standard.

---

Version 1.0.0

[Git Changes] Initial release.

Added

• Everything

Changed

• Everything

Fixed

• Everything

Removed

• Nothing