Bagaimanakah enum berfungsi dalam PHP 8.1+?

Question

Accepted Answer

**Enum** (enumeration, PHP 8.1+) mentakrifkan satu jenis dengan set nilai bernama yang tetap — ciri yang lama dinanti yang menyediakan keselamatan jenis (type safety) untuk set pilihan terhad (status, peranan, jenis) jauh lebih baik daripada pendekatan lama menggunakan pemalar kelas atau magic string.

## Enum tulen (hanya kes bernama)

```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 tulen mentakrifkan kes bernama. Apabila digunakan sebagai type hint, ia menjamin hanya nilai yang sah — menghapuskan pepijat akibat menghantar string/int sewenang-wenangnya.

## Backed enum (kes mempunyai nilai skalar)

```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 enum** mengaitkan setiap kes dengan satu skalar (string atau int) — berguna untuk menyimpan dalam pangkalan data atau melakukan serialisasi, dengan `from()`/`tryFrom()` untuk menukar daripada nilai dan `cases()` untuk menyenaraikan semua.

## Enum boleh mempunyai method dan pemalar

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

Enum boleh mempunyai method (dan melaksanakan interface), membolehkan anda melampirkan tingkah laku pada setiap kes — menjadikannya alat pemodelan domain yang berkuasa.

## Cara lama (apa yang enum gantikan)

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

## Mengapa ia penting

Enum (PHP 8.1+) ialah ciri penting dan lama dinanti yang membawa keselamatan jenis yang betul kepada set nilai terhad — dan memahaminya semakin perlu apabila pangkalan kod PHP moden mengadaptasinya.

Sebelum enum, pembangun mewakili set pilihan tetap (status, peranan, jenis, keadaan) dengan pemalar kelas atau string/int mentah, yang **tiada keselamatan jenis** (sebarang string diterima, jadi typo seperti `"actve"` dikompil dengan baik dan menyebabkan pepijat masa jalan) dan tiada cara untuk mengehadkan nilai yang sah.

Enum menyelesaikan ini: sebagai type hint, enum menjamin hanya kes yang sah boleh dihantar, menangkap nilai tidak sah pada peringkat jenis dan bukan sebagai pepijat masa jalan — peningkatan keselamatan yang ketara. **Backed enum** (dengan nilai skalar) berintegrasi dengan baik dengan pangkalan data dan serialisasi (`from()`/`tryFrom()` untuk penukaran), dan enum boleh mempunyai **method** (melampirkan tingkah laku pada setiap kes, mis. `label()` atau `isActive()`), menjadikannya berkuasa untuk pemodelan domain.

Memahami enum tulen berbanding backed, method-methodnya, dan cara ia menggantikan pendekatan pemalar/string lama yang terdedah ralat ialah pengetahuan penting untuk menulis PHP moden yang selamat jenis — memandangkan enum kini ialah cara idiomatik untuk memodelkan set nilai tetap dan digunakan secara meluas dalam framework dan aplikasi semasa, menguasainya mencerminkan kefasihan dengan PHP moden dan keupayaan untuk menulis kod yang lebih selamat, lebih ekspresif, dan mendokumentasikan diri yang mengelakkan satu kelas pepijat nilai-tidak-sah.