Si funksionojnë enums në PHP 8.1+?

Question

Accepted Answer

**Enums** (enumerations, PHP 8.1+) përcaktojnë një tip me një grup të fiksuar vlerash me emra — një tipar i pritur për shumë kohë që ofron siguri tipi për grupe të kufizuara opsionesh (statuse, role, lloje) shumë më mirë sesa qasja e vjetër e konstanteve të klasave ose stringjeve magjike.

## Pure enums (vetëm raste me emra)

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

Një pure enum përcakton raste me emra. Kur përdoret si tip hint, garanton vetëm vlera të vlefshme — duke eliminuar gabusat nga kalimi i stringjeve/inteve arbitrare.

## Backed enums (rastet kanë një vlerë skalare)

```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** shoqërojnë çdo rast me një skalare (string ose int) — i dobishëm për ruajtjen në një bazë të dhënash ose serializim, me `from()`/`tryFrom()` për të konvertuar nga vlerat dhe `cases()` për të renditur të gjitha.

## Enums mund të kenë metoda dhe 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"
```

Enums mund të kenë metoda (dhe të zbatojnë interfejse), duke ju lejuar të bashkëngjitni sjellje në çdo rast — duke i bërë ato mjete të fuqishme për modelimin e domenit.

## Mënyra e vjetër (atë që enums zëvendësojnë)

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

## Përse kjo është e rëndësishme

Enums (PHP 8.1+) janë një tipar i rëndësishëm, i pritur për shumë kohë që sjell siguri tipi të duhur në grupe të kufizuara vlerash — dhe përpunimi i tyre bëhet gjithnjë e më thelbësor ndërsa kodebazat moderne PHP i miratojnë ato.

Parë enums, zhvilluesit përfaqësuan grupe opsionesh të fiksuara (statuse, role, lloje, gjendje) me konstante klasash ose stringje/inte të pura, të cilat nuk ofronin **siguri tipi** (çdo string u pranua, kështu që tipar si `"actve"` u përpilua mirë dhe shkaktoi gabime në kohë ekzekutimi) dhe asnjë mënyrë për të kufizuar vlerat e vlefshme.

Enums e zgjidhin këtë: si një tip hint, një enum garanton që vetëm raste të vlefshme mund të kalojnë, duke kapur vlera të pavlefshme në nivelin e tipit në vend të gabimeve në kohë ekzekutimi — një përmirësim i rëndësishëm i sigurisë. **Backed enums** (me vlera skalare) integrohen mirë me bazat e të dhënave dhe serializimin (`from()`/`tryFrom()` për konvertim), dhe enums mund të kenë **metoda** (bashkëngjitje e sjelljes në çdo rast, p.sh. një `label()` ose `isActive()`), duke i bërë ato të fuqishme për modelimin e domenit.

Përmendja e pure vs backed enums, metodat e tyre, dhe si ato zëvendësojnë qasjen e vjetër të prirur ndaj gabimeve të konstanteve/stringjeve është njohuri e rëndësishme për të shkruar PHP moderne, të sigurt nga tipi — pasi enums tani janë mënyra idiomatike për të modeluar grupe vlerash të fiksuara dhe përdoren gjerësisht në korniza dhe aplikacione të tanishme, zotërimi i tyre pasqyron rrjedhshmëri me PHP moderne dhe aftësinë për të shkruar kod më të sigurt, më shprehës, të vetë-dokumentuar që parandalon një klasë të plotë të gabimeve të vlerave të pavlefshme.