PHP 8.1+ میں enums کیسے کام کرتے ہیں؟

Question

Accepted Answer

**Enums** (enumerations، PHP 8.1+) ایک ایسی قسم کی تعریف کرتے ہیں جس میں نام کی گئی values کا ایک مقررہ مجموعہ ہو — یہ ایک لمبے عرصے سے منتظر خصوصیت ہے جو مقید options (statuses, roles, types) کے لیے type safety فراہم کرتی ہے جو class constants یا magic strings کے پرانے طریقے سے بہت بہتر ہے۔

## خالص enums (صرف نام کی گئی cases)

```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 نام کی گئی cases کو بیان کرتا ہے۔ ایک type hint کے طور پر استعمال ہونے پر، یہ صرف درست values کی ضمانت دیتا ہے — arbitrary strings/ints پاس کرنے سے bugs کو ختم کرتا ہے۔

## Backed enums (cases کی scalar value ہے)

```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** ہر case کو ایک scalar (string یا int) کے ساتھ منسلک کرتے ہیں — database میں store کرنے یا serialize کرنے کے لیے کارآمد، `from()`/`tryFrom()` کے ساتھ values سے convert کرنے اور `cases()` سے تمام کو list کرنے کے لیے۔

## Enums کے پاس methods اور 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 کے پاس methods ہو سکتے ہیں (اور interfaces کو implement کر سکتے ہیں)، جو آپ کو ہر case کے ساتھ behavior منسلک کرنے دیتا ہے — انہیں powerful domain modeling tools بناتا ہے۔

## پرانا طریقہ (جو enums نے بدل دیا)

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

## یہ کیوں اہم ہے

Enums (PHP 8.1+) ایک اہم، لمبے عرصے سے منتظر خصوصیت ہے جو values کے مقید مجموعوں کو proper type safety فراہم کرتی ہے — اور جیسے جیسے جدید PHP codebases انہیں اپناتے ہیں، انہیں سمجھنا تیزی سے ضروری ہے۔

Enums سے پہلے، developers نے fixed option sets (statuses, roles, types, states) کو class constants یا raw strings/ints کے ساتھ represent کیا، جو **کوئی type safety فراہم نہیں کرتے تھے** (کوئی بھی string قبول کیا جاتا تھا، تو typos جیسے `"actve"` compile ہوتے تھے اور runtime bugs کا سبب بنتے تھے) اور valid values کو محدود کرنے کا کوئی طریقہ نہیں تھا۔

Enums اس کو حل کرتے ہیں: ایک type hint کے طور پر، enum صرف درست cases کو pass کیے جانے کی ضمانت دیتا ہے، invalid values کو runtime bugs کے بجائے type level پر پکڑتا ہے — ایک اہم سلامتی بہتری۔ **Backed enums** (scalar values کے ساتھ) databases اور serialization (`from()`/`tryFrom()` conversion کے لیے) کے ساتھ صاف طریقے سے integrate ہوتے ہیں، اور enums کے **methods** ہو سکتے ہیں (ہر case کے ساتھ behavior منسلک کرتے ہوئے، مثلاً `label()` یا `isActive()`)، انہیں domain modeling کے لیے powerful بناتے ہوئے۔

خالص اور backed enums، ان کے methods، اور یہ کہ وہ error-prone پرانے constant/string approach کو کیسے بدلتے ہیں، اس سے سمجھنا جدید، type-safe PHP لکھنے کے لیے اہم knowledge ہے — کیونکہ enums اب fixed value sets کو model کرنے کا idiomatic طریقہ ہیں اور موجودہ frameworks اور applications میں وسیع پیمانے پر استعمال ہوتے ہیں، انہیں سمھجھنا جدید PHP میں روانی کو ظاہر کرتا ہے اور محفوظ تر، زیادہ expressive، self-documenting code لکھنے کی صلاحیت کو ظاہر کرتا ہے جو invalid-value bugs کی ایک پوری class کو روکتا ہے۔