PHPackages                             prinsfrank/enums - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. prinsfrank/enums

ActiveLibrary[Utility & Helpers](/categories/utility)

prinsfrank/enums
================

Adds missing strictly typed methods to work with enums

v1.4.1(1y ago)2566.0k↓19.9%13MITPHPPHP ^8.1 || ^8.2 || ^8.3 || ^8.4CI passing

Since Dec 29Pushed 1y ago1 watchersCompare

[ Source](https://github.com/PrinsFrank/enums)[ Packagist](https://packagist.org/packages/prinsfrank/enums)[ GitHub Sponsors](https://github.com/PrinsFrank)[ RSS](/packages/prinsfrank-enums/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (6)Dependencies (4)Versions (7)Used By (3)

  ![Banner](https://github.com/PrinsFrank/enums/raw/main/docs/images/banner_light.png)Enums
=====

[](#enums)

[![GitHub](https://camo.githubusercontent.com/571bb300953b334a9b0bf5496786cd5a06ca1ec56576dbc784d9b6dbc7d27cd1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7072696e736672616e6b2f656e756d73)](https://camo.githubusercontent.com/571bb300953b334a9b0bf5496786cd5a06ca1ec56576dbc784d9b6dbc7d27cd1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7072696e736672616e6b2f656e756d73)[![PHP Version Support](https://camo.githubusercontent.com/ac05a518e8b994ebbe30d301d15d0d0176913ab3614a3a209066259d093fce31/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7072696e736672616e6b2f656e756d73)](https://camo.githubusercontent.com/ac05a518e8b994ebbe30d301d15d0d0176913ab3614a3a209066259d093fce31/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f7072696e736672616e6b2f656e756d73)[![codecov](https://camo.githubusercontent.com/d90d3dc09449102dccf664419ba32a0f19afdf1dadbc96b8fb6d0c6fdfe3d653/68747470733a2f2f636f6465636f762e696f2f67682f5072696e734672616e6b2f656e756d732f6272616e63682f6d61696e2f67726170682f62616467652e7376673f746f6b656e3d394f3356423536334d55)](https://codecov.io/gh/PrinsFrank/enums)[![PHPStan Level](https://camo.githubusercontent.com/83dd3d35cebed0eab9ee97ff1a5849c1344cda6a8ee9cac2cda20f5aa55b67bd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230392d627269676874677265656e2e7376673f7374796c653d666c6174)](https://camo.githubusercontent.com/83dd3d35cebed0eab9ee97ff1a5849c1344cda6a8ee9cac2cda20f5aa55b67bd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230392d627269676874677265656e2e7376673f7374796c653d666c6174)

**Adds missing strictly typed methods to work with enums**

Setup
-----

[](#setup)

> **Note**Make sure you are running PHP 8.1 or higher to use this package

To start right away, run the following command in your composer project;

`composer require prinsfrank/enums`

Or for development only;

`composer require prinsfrank/enums --dev`

How this package works
----------------------

[](#how-this-package-works)

### UnitEnum

[](#unitenum)

Let's assume we have the following UnitEnum:

```
enum Example {
    case Foo;

    #[HasSpecialMeaning]
    case Bar;
}
```

If we want to get a value by it's name from a string, we can call `fromName` or `tryFromName`;

```
UnitEnum::fromName(Example::class, 'Foo'); // Example::Foo
UnitEnum::tryFromName(Example::class, 'Foo'); // Example::Foo
```

The difference between the two methods is the way non-existing names are handled;

```
UnitEnum::fromName(Example::class, 'Example'); // @throws NameNotFoundException
UnitEnum::tryFromName(Example::class, 'Example'); // null
```

Another method that this package provides is to get an array of all the names for an enum;

```
UnitEnum::names(Example::class); // ['Foo', 'Bar']
```

And finally some methods to easily get the attributes of an enum case:

```
UnitEnum::hasCaseAttributes(Example::Bar, HasSpecialMeaning); // true
UnitEnum::getCaseAttributes(Example::Bar); // [new HasSpecialMeaning()]
```

### BackedEnum

[](#backedenum)

Let's assume we have the following BackedEnum: (It doesn't matter if an enum is backed by a string or an integer)

```
enum Example: string {
    case Foo = 'Foo';

    #[HasSpecialMeaning]
    case Bar = 'Bar';
}
```

If we want to get a value by it's name from a string, we can call `fromName` or `tryFromName`;

```
BackedEnum::fromName(Example::class, 'Foo'); // Example::Foo
BackedEnum::tryFromName(Example::class, 'Foo'); // Example::Foo
```

The difference between the two methods is the way non-existing names are handled;

```
BackedEnum::fromName(Example::class, 'Example'); // @throws NameNotFoundException
BackedEnum::tryFromName(Example::class, 'Example'); // null
```

Another method that this package provides is to get an array of all the names for an enum;

```
BackedEnum::names(Example::class); // ['Foo', 'Bar']
```

And finally some methods to easily get the attributes of an enum case:

```
BackedEnum::hasCaseAttributes(Example::Bar, HasSpecialMeaning); // true
BackedEnum::getCaseAttributes(Example::Bar); // [new HasSpecialMeaning()]
```

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity41

Moderate usage in the ecosystem

Community16

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 81.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~73 days

Recently: every ~91 days

Total

6

Last Release

552d ago

PHP version history (2 changes)v1.0PHP ^8.1 || ^8.2 || ^8.3

v1.3PHP ^8.1 || ^8.2 || ^8.3 || ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/288919c24dc651727390578a2bfe6ef020f6f508c30db717b54c943a9e2ac0b3?d=identicon)[PrinsFrank](/maintainers/PrinsFrank)

---

Top Contributors

[![PrinsFrank](https://avatars.githubusercontent.com/u/25006490?v=4)](https://github.com/PrinsFrank "PrinsFrank (26 commits)")[![szepeviktor](https://avatars.githubusercontent.com/u/952007?v=4)](https://github.com/szepeviktor "szepeviktor (6 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/prinsfrank-enums/health.svg)

```
[![Health](https://phpackages.com/badges/prinsfrank-enums/health.svg)](https://phpackages.com/packages/prinsfrank-enums)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)