pkly/enum-attribute-utils

Helper for easy attribute load/cache/fetch etc. in PHP Enums

1.0.0 2026-01-27 11:16 UTC

Requires

• php: >=8.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3
• pedrotroller/php-cs-custom-fixer: ^2
• phpstan/phpstan: ^2
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^12

MIT

• pkly

README

Helper for easy attribute load/cache/fetch etc. in PHP Enums

Installation

Simply run

composer require pkly/enum-attribute-utils

Usage

Example use on an enum.

use Pkly\EnumAttributeUtils\AttributeControlTrait;

enum ExampleEnum
{
    use AttributeControlTrait;

    #[NotAllowed]
    case Foo;

    #[CustomStuff(true)]
    case Bar;

    /**
     * @return list<self>
     */
    public static function getNotAllowed(): array
    {
        return self::findCases(NotAllowed::class);
    }

    public function isNotAllowed(): bool
    {
        return self::attributeExists(NotAllowed::class, $this);
    }

    public function getCustom(): CustomStuff|null
    {
        return self::findAttribute(CustomStuff::class, $this);
    }
}

See the trait for more methods.

Attributes are preloaded once per enum and stored in AttributeCache.

It's not suggested to touch said class, it's required as enums cannot contain properties.