Helper Methods

cases()

Use EnumHelper::cases() when you want the native case list but prefer to accept either Foo::class or a concrete case such as Foo::Bar .

EnumHelper::cases(Status::class);
EnumHelper::cases(Status::Draft);

names()

Use this when you need a simple list of case names without mapping over cases() manually.

Status::names();                 // ['Draft', 'Published']
EnumHelper::names(Status::class);

values()

Use this only with backed enums. It returns the scalar backing values in declaration order.

Status::values();                // ['draft', 'published']
EnumHelper::values(Status::class);

nameMap()

Returns case name => enum case .

Status::nameMap()['Draft'];      // Status::Draft

This is useful for validation, routing user input by case name, and cheap lookups without writing loops.

valueMap()

Returns backed value => enum case .

Status::valueMap()['draft'];     // Status::Draft

Use this when your system deals with external values such as API payloads, database values, or configuration arrays.

options()

Returns case name => backed value .

Status::options();               // ['Draft' => 'draft', 'Published' => 'published']

This is a good fit for:

• HTML selects
• CLI choice prompts
• schema or documentation generation
• admin UIs

tryFromName()

Returns null when the name does not exist.

Status::tryFromName('Draft');    // Status::Draft
Status::tryFromName('Unknown');  // null

fromName()

Throws ValueError when the name is invalid, matching the style of PHP's native from() behavior for backed enums.

Status::fromName('Draft');       // Status::Draft

hasName() and hasValue()

Use these as small intent-revealing checks when validating external input.

EnumHelper::hasName(Status::class, 'Draft'); // true
EnumHelper::hasValue(Status::class, 'draft'); // true

HasDescription

This trait turns CamelCase names into readable strings. It is useful as a low-cost default when you want something better than the raw case name.

LabeledEnumInterface and HasLabel

Use LabeledEnumInterface when a case needs an explicit presentation label. The package also ships with HasLabel as a simple default, but most user-facing enums will benefit from a custom implementation.

Comparable

Use Comparable when you want intent-revealing methods instead of ad-hoc strict comparisons.

Status::Draft->is(Status::Published);    // false
Status::Draft->isNot(Status::Published); // true
Status::Draft->in([Status::Draft, Status::Published]); // true