كيف تعمل enums في PHP 8.1+؟

Question

Accepted Answer

**Enums** (التعددات، PHP 8.1+) تعرّف نوعاً بمجموعة ثابتة من القيم المسماة — وهي ميزة طال انتظارها توفر سلامة نوعية للمجموعات المحدودة من الخيارات (الحالات، الأدوار، الأنواع) بشكل أفضل بكثير من الطريقة القديمة باستخدام ثوابت الفئة أو السلاسل النصية السحرية.

## Pure enums (الحالات المسماة فقط)

```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 الحالات المسماة. عند استخدامها كتلميح نوع، تضمن فقط القيم الصالحة — مما يلغي الأخطاء الناجمة عن تمرير سلاسل نصية أو أعداد صحيحة عشوائية.

## Backed enums (الحالات لها قيمة عددية)

```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** تربط كل حالة بقيمة عددية (سلسلة نصية أو عدد صحيح) — مفيدة للتخزين في قاعدة البيانات أو التسلسل، مع `from()`/`tryFrom()` للتحويل من القيم و`cases()` لعرض جميع الحالات.

## يمكن أن تحتوي Enums على دوال وثوابت

```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 على دوال (وتطبيق واجهات برمجية)، مما يسمح لك بإرفاق سلوك بكل حالة — مما يجعلها أدوات قوية لنمذجة المجال.

## الطريقة القديمة (ما تحل محله الـ 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+) ميزة مهمة وطال انتظارها تجلب سلامة نوعية حقيقية للمجموعات المحدودة من القيم — وفهمها أصبح ضروريًا بشكل متزايد مع اعتماد أسس أكواد PHP الحديثة عليها.

قبل الـ enums، كان المطورون يمثلون مجموعات الخيارات الثابتة (الحالات، الأدوار، الأنواع، الحالات) باستخدام ثوابت الفئة أو السلاسل النصية أو الأعداد الصحيحة، وهذا لم يوفر **سلامة نوعية** (كانت أي سلسلة نصية مقبولة، لذا الأخطاء المطبعية مثل `"actve"` كانت تُترجم بدون مشاكل وتسبب أخطاء وقت التشغيل) وليس هناك طريقة لتقييد القيم الصالحة.

الـ enums تحل هذه المشكلة: كتلميح نوع، تضمن enum أن يمكن فقط تمرير الحالات الصالحة، مما يلتقط القيم غير الصالحة على مستوى النوع بدلاً من أن تكون أخطاء وقت التشغيل — تحسين كبير في السلامة. **Backed enums** (بقيم عددية) تندمج بسلاسة مع قواعد البيانات والتسلسل (`from()`/`tryFrom()` للتحويل)، و enums يمكنها أن تحتوي على **دوال** (إرفاق سلوك بكل حالة، مثل `label()` أو `isActive()`)، مما يجعلها قوية لنمذجة المجال.

فهم pure enums مقابل backed enums، وطرقها، وكيف تحل محل طريقة الثابت والسلسلة النصية القديمة والعرضة للأخطاء مهم جداً لكتابة PHP حديثة وآمنة من الناحية النوعية — حيث أن الـ enums الآن هي الطريقة الأساسية لنمذجة مجموعات القيم الثابتة وتُستخدم على نطاق واسع في الأطر والتطبيقات الحالية، وإتقان استخدامها يعكس الطلاقة مع PHP الحديث والقدرة على كتابة رمز أكثر أماناً وتعبيراً وموثقاً ذاتياً يمنع فئة كاملة من أخطاء القيم غير الصالحة.