Laravel Packages

Enum Helpers for PHP

Published
Enum Helpers for PHP image

The release of PHP 8.1 brings native enumerations to PHP. The archtechx/enums composer package builds on native features and aims to make working with enums more lovable.

Using these library traits, you can add the following conveniences to your Enums in any PHP project:

  • Invokable cases - get the value of a backed Enum by invoking it
  • Names - return a list of case names in the enum
  • Values - return a list of case values in the enum
  • Options - return an associative array of case names and values

Given the above features, here are some examples from the package's readme file.

First up, here's how the InvokableCases trait works:

// Invokable
use ArchTech\Enums\InvokableCases;
 
enum TaskStatus: int
{
use InvokableCases;
 
case INCOMPLETE = 0;
case COMPLETED = 1;
case CANCELED = 2;
}
 
TaskStatus::INCOMPLETE(); // 0
TaskStatus::COMPLETED(); // 1
TaskStatus::CANCELED(); // 2

Next, here's how to get case names from enums:

use ArchTech\Enums\Names;
 
enum TaskStatus: int
{
use Names;
 
case INCOMPLETE = 0;
case COMPLETED = 1;
case CANCELED = 2;
}
 
TaskStatus::names();
// ['INCOMPLETE', 'COMPLETED', 'CANCELED']

The Values trait can return an array of possible enum values:

use ArchTech\Enums\Values;
 
enum TaskStatus: int
{
use Values;
 
case INCOMPLETE = 0;
case COMPLETED = 1;
case CANCELED = 2;
}
 
TaskStatus::values(); // [0, 1, 2]

Finally, the Options trait returns an associative array of names and values:

use ArchTech\Enums\Options;
 
enum TaskStatus: int
{
use Options;
 
case INCOMPLETE = 0;
case COMPLETED = 1;
case CANCELED = 2;
}
 
TaskStatus::options();
// ['INCOMPLETE' => 0, 'COMPLETED' => 1, 'CANCELED' => 2]

You can learn more about this package, get full installation instructions, and view the source code on GitHub.

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

Sponsored

serpapi logo
SerpApi

The Web Search API for Your LLM and AI Applications

Visit SerpApi

The latest

View all →
A simple form builder that stays out of your way image

A simple form builder that stays out of your way

Read article
Laravel AI: Trace Agent Runs With Lifecycle Events image

Laravel AI: Trace Agent Runs With Lifecycle Events

Read article
Laravel AI: Get Raw HTTP Responses and Rate Limits image

Laravel AI: Get Raw HTTP Responses and Rate Limits

Read article
Agent Run Observability in Laravel AI SDK 0.11 image

Agent Run Observability in Laravel AI SDK 0.11

Read article
Debounced Queued Event Listeners in Laravel image

Debounced Queued Event Listeners in Laravel

Read article
Statamic Mailables Viewer Previews Laravel Emails in the Control Panel image

Statamic Mailables Viewer Previews Laravel Emails in the Control Panel

Read article