Enums hufanyaje kazi katika PHP 8.1+?

Question

Accepted Answer

**Enums** (enumerations, PHP 8.1+) hufafanua aina yenye seti maalum ya thamani zenye majina — kipengele kilichosubiriwa kwa muda mrefu kinachotoa usalama wa aina kwa seti zilizofungwa za chaguo (statuses, roles, types) vizuri zaidi kuliko mbinu ya zamani ya class constants au magic strings.

## Pure enums (cases zenye majina tu)

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

Pure enum hufafanua cases zenye majina. Ikitumiwa kama type hint, huhakikisha thamani halali pekee — ikiondoa hitilafu zinazotokana na kupitisha strings/ints za hovyo.

## Backed enums (cases zenye thamani ya scalar)

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

**Backed enums** huhusisha kila case na scalar (string au int) — yenye manufaa kwa kuhifadhi kwenye hifadhidata au serializing, pamoja na `from()`/`tryFrom()` kubadilisha kutoka thamani na `cases()` kuorodhesha zote.

## Enums zinaweza kuwa na methods na constants

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

Enums zinaweza kuwa na methods (na kutekeleza interfaces), zikikuwezesha kuambatanisha tabia kwa kila case — na kuzifanya zana zenye nguvu za uundaji wa kikoa (domain modeling).

## Njia ya zamani (kile ambacho enums hubadilisha)

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

## Kwa nini ni muhimu

Enums (PHP 8.1+) ni kipengele muhimu, kilichosubiriwa kwa muda mrefu kinacholeta usalama wa aina ufaao kwa seti zilizofungwa za thamani — na kuelewa kwake kunazidi kuwa muhimu kadiri misimbo ya kisasa ya PHP inavyozikubali.

Kabla ya enums, wendelezaji waliwakilisha seti maalum za chaguo (statuses, roles, types, states) kwa class constants au strings/ints ghafi, ambazo zilitoa **usalama sifuri wa aina** (string yoyote ilikubaliwa, hivyo makosa ya kuandika kama `"actve"` yalikusanya bila tatizo na kusababisha hitilafu za runtime) na hakuna njia ya kuzuia thamani halali.

Enums hutatua hili: kama type hint, enum huhakikisha cases halali pekee zinaweza kupitishwa, ikinasa thamani zisizo halali katika kiwango cha aina badala ya kama hitilafu za runtime — uboreshaji mkubwa wa usalama. **Backed enums** (zenye thamani za scalar) huunganishwa kwa usafi na hifadhidata na serialization (`from()`/`tryFrom()` kwa ubadilishaji), na enums zinaweza kuwa na **methods** (kuambatanisha tabia kwa kila case, k.m. `label()` au `isActive()`), na kuzifanya zana zenye nguvu kwa uundaji wa kikoa.

Kuelewa pure dhidi ya backed enums, methods zao, na jinsi zinavyobadilisha mbinu ya zamani ya constant/string yenye makosa ni maarifa muhimu kwa kuandika PHP ya kisasa na yenye usalama wa aina — kwa kuwa enums sasa ndiyo njia inayofaa ya kuunda seti maalum za thamani na zinatumika sana katika frameworks na programu za sasa, kuzimudu huonyesha ufasaha wa PHP ya kisasa na uwezo wa kuandika msimbo salama zaidi, wenye kueleza zaidi, na unaojieleza ambao huzuia kundi zima la hitilafu za thamani zisizo halali.