Kif jaħdmu l-enums f'PHP 8.1+?

Question

Accepted Answer

**Enums** (enumerations, PHP 8.1+) jiddefinixxu tip b'sett fisso ta' valuri nomiati — feature mistrieħa għal żmien li tipprovdi type safety għal settijiet limitati ta' għażliet (statuses, roles, types) ħafna aħjar mill-approċċ antik ta' class constants jew magic strings.

## Pure enums (biss cases nomiati)

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

Enum purament jiddefinixi cases nomiati. Meta jintuża bħala type hint, huwa yiggarantizza valuri validi biss — jelimina l-bugs milli tippassa arbitrary strings/ints.

## Backed enums (cases għandhom valur 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** jassoċjaw kull case ma' scalar (string jew int) — utli għall-ħżin f'database jew serializzazzjoni, b' `from()`/`tryFrom()` biex tikkonverti minn valuri u `cases()` biex tistixxel kollha.

## Enums jista jkollhom metodi u 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 jista jkollhom metodi (u jimplimentaw interfaces), li jippermettulek tattakka behavior għal kull case — li tagħmlihom strumenti qawwija għal domain modeling.

## Il-mod antik (dak li l-enums jissostitwixxu)

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

## Għaliex dan importanti

Enums (PHP 8.1+) huma feature importanti, mistrieħa għal żmien li tġib type safety proprju għal settijiet limitati ta' valuri — u l-fehim tiegħom ikun essenzjali dejjem aktar bħal ma PHP codebases moderni jadottawhom.

Qabel l-enums, l-iżviluppaturi rappreżentaw settijiet fissi ta' għażliet (statuses, roles, types, states) b'class constants jew raw strings/ints, li ma offrixxux **type safety** (kwalunkwe string kien aċċettat, allura typos bħal `"actve"` kpilati tajjeb u kkawzaw runtime bugs) u l-ebda mod biex tikkonstrainǧi valuri validi.

Enums jissolvu dan: bħala type hint, enum iggarantizza biss cases validi jistgħu jitppassaw, u jaqbdu valuri invalidi fil-livell tat-tip minflok bħala runtime bugs — tkabbir signifikanti ta' safety. **Backed enums** (b'valuri scalar) jintegraw ċatt mad-databases u serializzazzjoni (`from()`/`tryFrom()` għal konverżjoni), u enums jista jkollhom **metodi** (li jattakkaw behavior għal kull case, eż. `label()` jew `isActive()`), u jagħmluhom qawwija għal domain modeling.

L-fehim ta' pure vs backed enums, il-metodi tagħhom, u kif jissostitwixxu l-approċċ antik error-prone ta' constants/strings hija ġarfien importanti għall-kitba ta' PHP moderni, type-safe — billi l-enums issa huma l-mod idiomatiku biex tumudellaw settijiet ta' valuri fissi u jintużaw ħafna f'frameworks u applikazzjonijiet attwali, u l-master tagħhom jirriflettu fluwenza mal-PHP moderni u l-abilità li tikteb code iktar sigur, ifisser, self-documenting li jipprevjeni klassi sħiħa ta' bugs ta' valuri invalidi.