Supercharge Your PHP Enums with archtechx/enums

July 1, 2025

Supercharge Your PHP Enums with `archtechx/enums`

PHP 8.1 introduced native enums—type‑safe sets of named values like statuses or roles. The archtechx/enums package adds traits that reduce boilerplate and enhance DX (Developer Experience).

✨ Key Features

InvokableCases: Call enum cases directly to get value or name, no more ->value.
Names: Get an array of case names.
Values: Fetch values (backed enums) or names (pure enums).
Options: Associative array of case => value.
From: Adds from(), tryFrom(), fromName(), tryFromName().
Metadata: Associate attributes like description/color per case.
Comparable: Compare enums with is(), isNot(), in(), notIn().

📦 Installation

Requires PHP 8.1+. Install via Composer:

composer require archtechx/enums

🧩 Examples

1. InvokableCases

use ArchTech\Enums\InvokableCases;

enum TaskStatus: int {
  use InvokableCases;
  case INCOMPLETE = 0;
  case COMPLETED = 1;
  case CANCELED = 2;
}

TaskStatus::COMPLETED(); // ⇒ 1

2. Names & Values

use ArchTech\Enums\Names;
use ArchTech\Enums\Values;

enum Role {
  use Names, Values;
  case ADMIN, USER, GUEST;
}

Role::names(); // ⇒ ['ADMIN', 'USER', 'GUEST']
Role::values(); // ⇒ ['ADMIN', 'USER', 'GUEST']

3. Options & stringOptions()

use ArchTech\Enums\Options;

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

TaskStatus::stringOptions();
// ⇒ "Incomplete…"

4. From / tryFrom / fromName / tryFromName

use ArchTech\Enums\From;

enum Role: string {
  use From;
  case ADMIN = 'admin';
  case USER = 'user';
}

Role::from('admin');        // ⇒ Role::ADMIN
Role::tryFrom('unknown');   // ⇒ null
Role::fromName('USER');     // ⇒ Role::USER

5. Metadata

use ArchTech\Enums\Metadata;
use ArchTech\Enums\Meta\Meta;
use App\Enums\Meta\{Description, Color};

#[Meta(Description::class, Color::class)]
enum TaskStatus: int {
  use Metadata;
  #[Description('Incomplete')] #[Color('red')]
  case INCOMPLETE = 0;
}
TaskStatus::INCOMPLETE->description(); // ⇒ 'Incomplete'

6. Comparable

use ArchTech\Enums\Comparable;

enum TaskStatus: int {
  use Comparable;
  case INCOMPLETE = 0;
  case COMPLETED = 1;
}

TaskStatus::INCOMPLETE->is(TaskStatus::INCOMPLETE); // ⇒ true

✅ Best Practices

Use InvokableCases instead of ->value for readability and IDE support.
Populate form selects with options().
Use tryFrom() for safe input handling.
Group enums in an app/Enums directory in Laravel projects.

This package makes PHP enums way more powerful and developer-friendly—perfect for Laravel, APIs, forms, and metadata‑rich logic.

Blog

Efficient Reporting & Big Data Reports with Queues

Jul 07, 2025

How to cache report queries with fixed timelines How to generate large reports asynchronously using job queues 1. 🧠 Report Query Caching wi...

Object-Oriented Programming (OOP) – Core Concepts

Aug 09, 2025

Object-Oriented Programming (OOP) is a modern software development approach that divides an application into units called Objects that interact with...

Essential React Native UI & Interaction Components

Jul 01, 2025

Essential React Native UI & Interaction Components React Native provides a powerful set of built-in components for creating native mobile apps....

Laravel Queue & Job System: From Table Creation to Production Deployment

Jul 01, 2025

🚀 Laravel Queue & Job System We’re gonna walk you through Laravel queues from setup to deploying in production using Supervisor. Step 1...

Laravel 12.16.0 - New Features for Developers

Jun 03, 2025

Laravel 12.16.0 - New Features for Developers 1. New Validation Rule: in_array_keys You can now validate that an array contains at least one of the...

Using useCallback in React: Benefits, Limitations, Best Practices

Jul 31, 2025

The useCallback hook in React is used to return a memoized version of a callback function, so it's only recreated when its dependencies change. The...