README

Native PHP enums with Laravel-friendly helpers for labels, selects, validation, and case filtering.

Overview

The Enumable trait enhances backed PHP enums (string or int) with utilities for forms, APIs, and validation—without replacing native enums.

Installation

composer require dilovanmatini/laravel-enumable

No service provider or configuration is required.

Upgrading from 1.0.x? See UPGRADE.md.

Requirements

• PHP 8.1 or higher (Laravel 13 applications require PHP 8.3+)
• Laravel 10, 11, 12, or 13

Usage

use DilovanMatini\Enumable\Traits\Enumable;

enum Status: string
{
    use Enumable;

    case Draft = 'draft';
    case Published = 'published';
}

Methods

Class methods

Instance methods

Examples

// Lists & selects
Status::values();           // ['draft', 'published']
Status::labels();           // ['draft' => 'Draft', 'published' => 'Published']
Status::toSelectArray();    // same as labels()

// Resolution
Status::getCase('draft');   // Status::Draft
Status::fromName('Draft');  // Status::Draft

// Validation (Form Request)
Status::rule();
Status::ruleOnly(['draft', 'published']);

// Filtering (subset supports static and instance calls, same as 1.0.x)
Status::except(['draft'])::labels();
Status::only([Status::Published])->cases();

// Instance helpers
Status::Draft->label();
Status::Draft->str()->slug();       // "draft"
Status::Draft->is('draft');         // true

Custom labels

Prefer labelsMap() (or keep using setLabels() for backward compatibility):

public static function labelsMap(): array
{
    return [
        self::Draft->value => 'Draft (hidden)',
        self::Published->value => 'Live',
    ];
}

Default case

Override default() on your enum:

public static function default(): self
{
    return self::Draft;
}

Blade select

<select name="status">
    @foreach (Status::toSelectArray() as $value => $label)
        <option value="{{ $value }}">{{ $label }}</option>
    @endforeach
</select>

Eloquent

Use Laravel's native enum casting:

protected $casts = [
    'status' => Status::class,
];

Backed enums only

Methods that rely on a backed value (values(), labels(), only(), etc.) require string or int backed enums. Unit enums support name-based helpers such as fromName() and exists() by name.

Migrating from BenSampo/laravel-enum

Comparison with Other Enum Packages

Legend: ✔️ = Supported; ❌ = Not Supported; Manual = Can be achieved but requires additional code.
Last reviewed: Laravel Enumable v1.1.0, BenSampo\Enum v5.x, PHP 8.1+ enums.

Changelog

See CHANGELOG.md for release notes.

License

MIT © Dilovan Matini