Enums (перечисления, PHP 8.1+) определяют тип с фиксированным набором именованных значений — долгожданная функция, обеспечивающая type safety для ограниченных наборов опций (статусы, роли, типы) намного лучше, чем старый подход с классовыми константами или магическими строками.
{
Active;
Inactive;
Pending;
}
= ::;
{}
(::);
();
Pure enum определяет именованные случаи. При использовании в качестве type hint гарантирует только допустимые значения — исключая ошибки от передачи произвольных строк/целых чисел.
enum Status: string { // "backed" by string values
case Active = 'active';
case Inactive = 'inactive';
case Pending = 'pending';
}
Status::Active->value; // 'active' — the backing value
Status::from('active'); // Status::Active — convert FROM the value
Status::tryFrom('bad'); // null if invalid (instead of throwing)
Status::cases(); // [Active, Inactive, Pending] — all cases
Backed enums связывают каждый случай со скалярным значением (string или int) — полезно для хранения в базе данных или сериализации, с from()/tryFrom() для преобразования значений и cases() для списка всех.
enum Status: string {
case Active = 'active';
case Inactive = 'inactive';
public function label(): string { // methods on the enum
return match($this) {
Status::Active => 'Active User',
Status::Inactive => 'Inactive User',
};
}
public function isActive(): bool {
return $this === Status::Active;
}
}
Status::Active->label(); // "Active User"
Enums могут иметь методы (и реализовывать интерфейсы), позволяя вам присоединять поведение к каждому случаю — делая их мощными инструментами моделирования предметной области.
// ❌ before enums — class constants or magic strings: no type safety, typo-prone
class Status { const ACTIVE = 'active'; const INACTIVE = 'inactive'; }
function setStatus(string $s) {} // accepts ANY string — "actve" typo compiles fine
Enums (PHP 8.1+) — важная, долгожданная функция, которая обеспечивает надлежащую type safety для ограниченных наборов значений — и их понимание становится все более существенным, поскольку современные PHP-кодовые базы их внедряют.
До появления enums разработчики представляли фиксированные наборы опций (статусы, роли, типы, состояния) с помощью классовых констант или сырых строк/целых чисел, что не обеспечивало type safety (любая строка принималась, поэтому опечатки типа "actve" компилировались нормально и вызывали runtime-ошибки) и не было способа ограничить допустимые значения.
Enums решают эту проблему: как type hint, enum гарантирует, что могут быть переданы только допустимые случаи, перехватывая недопустимые значения на уровне типов, а не как runtime-ошибки — значительное улучшение безопасности. Backed enums (со скалярными значениями) гладко интегрируются с базами данных и сериализацией (from()/tryFrom() для преобразования), а enums могут иметь методы (присоединяя поведение к каждому случаю, например label() или isActive()), делая их мощными для моделирования предметной области.
Понимание pure vs backed enums, их методов и того, как они заменяют подверженный ошибкам старый подход с константами/строками, — это важные знания для написания современного, type-safe PHP — поскольку enums теперь являются идиоматичным способом моделирования фиксированных наборов значений и широко используются в текущих фреймворках и приложениях, их освоение отражает беглость с современным PHP и способность писать более безопасный, выразительный, самодокументируемый код, который предотвращает целый класс ошибок недопустимых значений.