Jak działają enumy w PHP 8.1+?

Question

Accepted Answer

**Enumy** (wyliczenia, PHP 8.1+) definiują typ ze stałym zestawem nazwanych wartości — długo oczekiwana funkcja, która zapewnia bezpieczeństwo typów dla ograniczonych zbiorów opcji (statusy, role, typy) znacznie lepiej niż stary sposób z wykorzystaniem stałych klas lub magicznych stringów.

## Czyste enumy (tylko nazwane przypadki)

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

Czysty enum definiuje nazwane przypadki. Używany jako typ wskazówki, gwarantuje tylko prawidłowe wartości — eliminując błędy z przekazywaniem dowolnych stringów/liczb całkowitych.

## Wspierane enumy (przypadki mają wartość skalarną)

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

**Wspierane enumy** kojarzą każdy przypadek ze wartością skalarną (string lub int) — przydatne do przechowywania w bazie danych lub serializacji, z `from()`/`tryFrom()` do konwersji z wartości i `cases()` do wylistowania wszystkich.

## Enumy mogą mieć metody i stałe

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

Enumy mogą mieć metody (i implementować interfejsy), umożliwiając przypisanie zachowania każdemu przypadkowi — czyniąc je potężnymi narzędziami modelowania domeny.

## Stary sposób (co enumy zastępują)

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

## Dlaczego to ważne

Enumy (PHP 8.1+) są ważną, długo oczekiwaną funkcją, która zapewnia właściwe bezpieczeństwo typów dla ograniczonych zbiorów wartości — i zrozumienie ich jest coraz bardziej niezbędne, gdy nowoczesne bazy kodu PHP je przyjmują.

Przed enumami deweloperzy reprezentowali stałe zbiory opcji (statusy, role, typy, stany) ze stałymi klas lub surowych stringów/liczb całkowitych, które oferowały **brak bezpieczeństwa typów** (każdy string był akceptowany, więc literówki takie jak `"actve"` kompilowały się prawidłowo i powodowały błędy w runtime) i brak sposobu na ograniczenie prawidłowych wartości.

Enumy rozwiązują ten problem: jako typ wskazówki, enum gwarantuje, że można przekazać tylko prawidłowe przypadki, łapiąc nieprawidłowe wartości na poziomie typu, a nie jako błędy runtime — znaczna poprawa bezpieczeństwa. **Wspierane enumy** (ze wartościami skalarnymi) integrują się czyszczę z bazami danych i serializacją (`from()`/`tryFrom()` dla konwersji), a enumy mogą mieć **metody** (przypisując zachowanie każdemu przypadkowi, np. `label()` lub `isActive()`), czyniąc je potężnymi do modelowania domeny.

Zrozumienie czystych i wspieranych enumów, ich metod, i jak zastępują one błędy podatne stare podejście stałych/stringów jest ważną wiedzą do pisania nowoczesnego, typowo-bezpiecznego PHP — ponieważ enumy są teraz idiomatycznym sposobem do modelowania stałych zbiorów wartości i są szeroko używane w obecnych frameworkach i aplikacjach, opanowanie ich odzwierciedla płynność w nowoczesnym PHP i zdolność do pisania bezpieczniejszego, bardziej wyrazistego, samodzielnie dokumentującego się kodu, który zapobiega całej klasie błędów związanych z nieprawidłowymi wartościami.