Enums (enumerações, PHP 8.1+) definem um tipo com um conjunto fixo de valores nomeados — um recurso muito aguardado que oferece segurança de tipo para conjuntos restritos de opções (statuses, roles, tipos) muito melhor do que a abordagem antiga de constantes de classe ou strings mágicas.
{
Active;
Inactive;
Pending;
}
= ::;
{}
(::);
();
Uma enum pura define casos nomeados. Usado como uma dica de tipo, garante apenas valores válidos — eliminando bugs que surgem ao passar strings/ints arbitrárias.
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
Enums com backup associam cada caso a um valor escalar (string ou int) — útil para armazenar em um banco de dados ou serializar, com from()/tryFrom() para converter de valores e 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"
Enums podem ter métodos (e implementar interfaces), permitindo que você anexe comportamento a cada caso — tornando-as ferramentas poderosas de modelagem de domínio.
// ❌ 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+) são um recurso importante e muito aguardado que traz segurança de tipo adequada a conjuntos restritos de valores — e compreendê-los é cada vez mais essencial, pois as bases de código PHP modernas as adotam.
Antes das enums, os desenvolvedores representavam conjuntos fixos de opções (statuses, roles, tipos, estados) com constantes de classe ou strings/ints brutas, o que oferecia nenhuma segurança de tipo (qualquer string era aceita, então erros de digitação como "actve" compilavam corretamente e causavam bugs em tempo de execução) e nenhuma maneira de restringir valores válidos.
Enums resolvem isso: como uma dica de tipo, uma enum garante que apenas casos válidos possam ser passados, capturando valores inválidos no nível do tipo em vez de como bugs em tempo de execução — uma melhoria significativa de segurança. Enums com backup (com valores escalares) se integram perfeitamente com bancos de dados e serialização (from()/tryFrom() para conversão), e enums podem ter métodos (anexando comportamento a cada caso, por exemplo um label() ou isActive()), tornando-as poderosas para modelagem de domínio.
Compreender enums puras versus enums com backup, seus métodos e como elas substituem a abordagem antiga propensa a erros de constantes/strings é conhecimento importante para escrever PHP moderno e type-safe — já que enums são agora a forma idiomática de modelar conjuntos de valores fixos e são amplamente usadas em frameworks e aplicações atuais, dominá-las reflete fluência com PHP moderno e a capacidade de escrever código mais seguro, mais expressivo, auto-documentado que previne uma classe inteira de bugs de valores inválidos.