Kaip veikia enumai PHP 8.1+?

Question

Accepted Answer

**Enumai** (enumeracijos, PHP 8.1+) apibrėžia tipą su fiksuotu pavadinimų reikšmių rinkiniu — ilgai laukta funkcija, kuri suteikia tipo saugumą apribotos parinkčių aibei (statusai, vaidmenys, tipai) daug geriau nei senieji klasės konstancių arba stebuklių eilučių metodai.

## Grynai enumai (tik pavadinti atvejai)

```php
<?php
enum Status {
    case Active;
    case Inactive;
    case Pending;
}

$status = Status::Active;          // a value of type Status
function setStatus(Status $s) {}    // type-safe parameter — only Status values allowed
setStatus(Status::Active);          // ✅
setStatus("active");                 // ❌ TypeError — not a Status
```

Grynas enumas apibrėžia pavadintuosius atvejus. Naudojant kaip tipo užuominą, jis garantuoja tik galiojančias reikšmes — panaikinant klaidas dėl savavališkų eilučių/sveikųjų skaičių persiuntimo.

## Paremti enumai (atvejai turi skaliarinę reikšmę)

```php
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
```

**Paremti enumai** susieja kiekvieną atvejį su skaliarine reikšme (eilute arba sveikuoju skaičiumi) — naudinga duomenų bazėje saugoti arba serializuoti, su `from()`/`tryFrom()` reikšmėms konvertuoti ir `cases()` visiems išvardyti.

## Enumai gali turėti metodus ir konstantas

```php
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"
```

Enumai gali turėti metodus (ir įgyvendinti sąsajas), leidžiantys pridėti elgesį prie kiekvieno atvejo — todėl jie yra galingi domeno modeliavimo įrankiai.

## Senasis būdas (ką pakeičia enumai)

```php
// ❌ 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
```

## Kodėl tai svarbu

Enumai (PHP 8.1+) yra svarbi, ilgai laukta funkcija, kuri suteikia tikrą tipo saugumą apribotom reikšmių aibėm — ir jų supratimas yra vis labiau būtinas, nes šiuolaikiniai PHP kodų pagrindai juos priima.

Prieš enumus, programuotojai fiksuotus parinkčių rinkinius (statusus, vaidmenis, tipus, būsenas) reprezentavo klasės konstantomis arba žaliomis eilutėmis/sveikaisiais skaičiais, kurie neteikė **jokio tipo saugumo** (buvo priimta bet kuri eilutė, todėl rašybos klaidos kaip `"actve"` buvo sukompiliuotos ir sukėlė vykdymo klaidų) ir negalėjo apriboti galiojančių reikšmių.

Enumai sprendžia šią problemą: kaip tipo užuomina, enumas garantuoja, kad gali būti perduoti tik galiojantys atvejai, sutraukdami negaliojančias reikšmes tipo lygiu, o ne kaip vykdymo klaidas — reikšmingas saugumo pagerinimas. **Paremti enumai** (su skalarinėmis reikšmėmis) sklandžiai integruojasi su duomenų bazėmis ir serializavimu (`from()`/`tryFrom()` konversijai), o enumai gali turėti **metodus** (pridedant elgesį prie kiekvieno atvejo, pvz., `label()` arba `isActive()`), todėl jie yra galingi domeno modeliavimui.

Grynųjų ir paremtų enumų, jų metodų ir kaip jie pakeičia klaidingą senąjį konstancių/eilučių metodą, supratimas yra svarbus šiuolaikinio, tipo saugumo atžvilgiu, PHP žinios — kadangi enumai dabar yra idiomatinis fiksuotų reikšmių aibių modeliavimo būdas ir plačiai naudojami dabartinėse sistemose bei programose, jų įvaldymas rodo sklandumą su šiuolaikiniu PHP ir gebėjimą rašyti saugesni, išraiškingesnį, savidokumentuojantį kodą, kuris apsaugo nuo visos neteisingų reikšmių klaidų klasės.