Kako delujejo enumeracije v PHP 8.1+?

Question

Accepted Answer

**Enumeracije** (enumerations, PHP 8.1+) definirajo tip s fiksnim naborom poimenovanih vrednosti — dolgo pričakovana funkcionalnost, ki zagotavlja varnost tipov za omejena niza možnosti (statusi, vloge, vrste) much bolje kot stari pristop s konstantami razreda ali čarobnimi nizi.

## Čiste enumeracije (samo poimenovani primeri)

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

Čista enumeracija definira poimenovane primere. Ko se uporablja kot tip namiga, garantira samo veljavne vrednosti — odpravljajući napake pri posredovanju poljubnih nizov/celihih števil.

## Zavarovane enumeracije (primeri imajo skalarno vrednost)

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

**Zavarovane enumeracije** povezujejo vsak primer s skalarno vrednostjo (niz ali celo število) — koristno za shranjevanje v podatkovni bazi ali serializacijo, z `from()`/`tryFrom()` za pretvorbo iz vrednosti in `cases()` za seznam vseh.

## Enumeracije lahko imajo metode in konstante

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

Enumeracije lahko imajo metode (in implementirajo vmesnike), ki vam omogočajo, da priložite obnašanje vsakemu primeru — kar jih naredi zmogljiva orodja za modeliranje domene.

## Stari način (kar nadomestijo enumeracije)

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

## Zakaj je to pomembno

Enumeracije (PHP 8.1+) so pomembna, dolgo pričakovana funkcionalnost, ki prinaša pravo varnost tipov v omejena niza vrednosti — in razumevanje njih je vedno bolj bistveno, ker sodobne PHP bazo kode že sprejemajo.

Pred enumeracijami so razvijalci predstavljali fiksne naborе možnosti (statusi, vloge, vrste, stanja) s konstantami razreda ali surovimi nizi/celimi števili, kar ni ponujalo **nobene varnosti tipov** (vsak niz je bil sprejet, zato so tipkarke napake, kot je `"actve"`, pravilno kompilirale in povzročile napake med izvajanjem) in nobena pot za omejevanje veljavnih vrednosti.

Enumeracije to rešijo: kot tip namiga enumeracija garantira, da je mogoče posredovati samo veljavne primere, kar ujame neveljavne vrednosti na ravni tipa, namesto kot napake med izvajanjem — občutno izboljšanje varnosti. **Zavarovane enumeracije** (s skalarnimi vrednostmi) se čisto integrirajo s podatkovnimi bazami in serializacijo (`from()`/`tryFrom()` za pretvorbo), in enumeracije lahko imajo **metode** (pripenjanje obnašanja vsakemu primeru, npr. `label()` ali `isActive()`), kar jih naredi zmogljive za modeliranje domene.

Razumevanje čistih in zavarovanих enumeracij, njihovih metod in kako nadomestijo napako-nagnjeni stari pristop konstant/nizov je pomembno znanje za pisanje sodobnega, varnega tipa PHP — ker so enumeracije zdaj idiomatski način za modeliranje fiksnih nizov vrednosti in so v obsegom uporabljene v sedanjih ogrodjih in aplikacijah, obvladovanje njih odraža tekoče znanje sodobnega PHP in sposobnost pisanja varnejše, bolj izrazne, samopojasnjujoče kode, ki prepreči celoten razred napak z neveljavnimi vrednostmi.