Enums (enumeraciones, PHP 8.1+) definen un tipo con un conjunto fijo de valores nombrados — una característica que llevaba mucho tiempo esperándose y que proporciona seguridad de tipos para conjuntos restringidos de opciones (estados, roles, tipos) mucho mejor que el antiguo enfoque de constantes de clase o cadenas mágicas.
{
Active;
Inactive;
Pending;
}
= ::;
{}
(::);
();
Un enum puro define casos nombrados. Usado como un type hint, garantiza solo valores válidos — eliminando los errores de pasar cadenas/enteros arbitrarios.
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
Los enums respaldados asocian cada caso con un escalar (cadena o entero) — útil para almacenar en una base de datos o serializar, con from()/tryFrom() para convertir desde valores y cases() para listar todos.
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"
Los enums pueden tener métodos (e implementar interfaces), permitiéndote adjuntar comportamiento a cada caso — convirtiéndolos en herramientas poderosas de modelado de dominio.
// ❌ 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
Los enums (PHP 8.1+) son una característica importante y esperada desde hace mucho tiempo que aporta seguridad de tipos adecuada a conjuntos de valores restringidos — y comprenderlos es cada vez más esencial a medida que los códigos PHP modernos los adoptan.
Antes de los enums, los desarrolladores representaban conjuntos de opciones fijas (estados, roles, tipos, condiciones) con constantes de clase o cadenas/enteros sin procesar, lo que ofrecía sin seguridad de tipos (cualquier cadena era aceptada, así que errores tipográficos como "actve" compilaban correctamente y causaban errores en tiempo de ejecución) y sin forma de restringir valores válidos.
Los enums resuelven esto: como un type hint, un enum garantiza que solo casos válidos puedan ser pasados, capturando valores inválidos a nivel de tipos en lugar de como errores en tiempo de ejecución — una mejora de seguridad significativa. Los enums respaldados (con valores escalares) se integran limpiamente con bases de datos y serialización (from()/tryFrom() para conversión), y los enums pueden tener métodos (adjuntando comportamiento a cada caso, p. ej. un label() o isActive()), convirtiéndolos en poderosos para modelado de dominio.
Comprender enums puros versus respaldados, sus métodos, y cómo reemplazan el antiguo enfoque propenso a errores de constantes/cadenas es conocimiento importante para escribir PHP moderno y seguro en tipos — ya que los enums son ahora la forma idiomática de modelar conjuntos de valores fijos y son ampliamente usados en marcos de trabajo y aplicaciones actuales, dominarlos refleja fluidez con PHP moderno y la capacidad de escribir código más seguro, expresivo y autodocumentado que previene una clase completa de errores de valores inválidos.