Readable labels

readable() turns a case into a human-friendly label: it runs the backed value — or the case name on a pure enum — through Str::headline(), then looks the headline up in Laravel’s translator for the current locale. Without a matching translation the headline itself is returned. label() is an alias for UI code that prefers that name:

NewsCategory::HotNews->readable(); // "Hot News"
NewsCategory::HotNews->label();    // "Hot News"

enum Status { use Helpers; case Active; }

Status::Active->readable(); // "Active"

How values become labels

The label is derived from the value, not the case name, so choose values that read well — or translate them. Every other label-based helper — labels(), toOptions(), toArray(), options(), fromLabel() and tryFromLabel() — goes through readable(), so a custom or translated label applies everywhere at once.

Labels come from the application’s translator, so label-producing methods need a booted Laravel app. If a headline happens to name a whole translation group instead of a line — “Auth” matches lang/en/auth.php on a case-insensitive filesystem — the untranslated headline is returned rather than the group.

All labels at once

NewsCategory::labels()->all(); // ['Hot News', 'Regular News', 'Private News']