Skip to content
OpenCloseEsc
Tips
  • Laravel
  • enums
  • php

One details() match instead of label(), color() and hint()

Put everything the UI needs about a case in one array per case, and read label() and meta() from it; adding a case means one new arm, and match still throws when it is missing.

1 min read

Three match blocks per enum means three places to forget a new case. Keep one.

enum UserStatus: string
{
    use EnumHelpers;
 
    case Active = 'active';
    case Inactive = 'inactive';
    case Blocked = 'blocked';
 
    public function details(): array
    {
        return match ($this) {
            self::Active => ['color' => 'green', 'hint' => 'Can log in and work.'],
            self::Inactive => ['color' => 'gray', 'hint' => 'Hidden from assignment lists.'],
            self::Blocked => ['color' => 'red', 'hint' => 'Cannot log in.'],
        };
    }
}

In the trait, label() returns details()['label'] ?? Str::headline($this->name), so SuperAdmin reads "Super Admin" without writing it, and meta() is Arr::except($this->details(), 'label'). A case only writes what differs from the default. toArray() sends {value, label, meta} to the frontend; cast meta to (object) or an empty array arrives in JavaScript as [].

Related tips

New
  • Laravel
  • enums
  • php

Give every enum the same ten lines

A small trait adds values(), names() and options() to every backed enum, so whereIn clauses, validation lists and select inputs read the cases instead of a copied array.
Published on
1 min readNew
  • Laravel
  • database
  • enums
  • migrations

A plain string column, not a MySQL enum

Adding a case to a MySQL ENUM column is an ALTER TABLE that can lock a big table for minutes. A string column with an index stores the same values, and the PHP enum does the checking.
Published on
1 min read