PHP 8.1+ sürümlerinde enumlar nasıl çalışır?

Question

Accepted Answer

**Enumlar** (numaralandırmalar, PHP 8.1+) sabit bir dizi adlandırılmış değeri olan bir tür tanımlar — uzun süredir beklenen bir özelliktir ve sabit seçenek setleri (statüler, roller, tipler) için eski class constant veya magic string yaklaşımından çok daha iyi tür güvenliği sağlar.

## Saf enumlar (sadece adlandırılmış durumlar)

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

Saf bir enum adlandırılmış durumları tanımlar. Bir tür ipucu olarak kullanıldığında, yalnızca geçerli değerleri garanti eder — keyfi string/int geçişinden kaynaklanan hataları ortadan kaldırır.

## Desteklenen enumlar (durumların skaler bir değeri vardır)

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

**Desteklenen enumlar** her durumu bir skaler (string veya int) ile ilişkilendirir — bir veritabanında depolamak veya seri hale getirmek için yararlıdır; değerleri dönüştürmek için `from()`/`tryFrom()` ve tümünü listelemek için `cases()` kullanılır.

## Enumlar metotlara ve sabitlere sahip olabilir

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

Enumlar metotlara (ve arayüzleri uygulayabilir) sahip olabilir — her duruma davranış eklemenizi sağlar ve bu da onları güçlü domain modeling araçları haline getirir.

## Eski yol (enumların yerine geçtiği)

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

## Neden önemli

Enumlar (PHP 8.1+), sabit değer setlerine uygun tür güvenliği getiren önemli ve uzun süredir beklenen bir özelliktir — ve bunları anlamak, modern PHP kod tabanları onları benimsedikçe giderek daha önemli hale gelir.

Enumlardan önce, geliştirici ler sabit seçenek setlerini (statüler, roller, tipler, durumlar) class constantları veya raw string/int ile temsil ederlerdi — bunlar **tür güvenliği sunmadıkları** (herhangi bir string kabul edildiği için `"actve"` gibi yazım hataları düzgün bir şekilde derlenip runtime hatalarına neden olurdu) ve geçerli değerleri kısıtlamanın bir yolu yoktu.

Enumlar bu sorunu çözer: bir tür ipucu olarak, bir enum yalnızca geçerli durumların geçirileceğini garanti eder — geçersiz değerleri runtime hataları yerine tür seviyesinde yakalar ve bu da önemli bir güvenlik iyileştirmesidir. **Desteklenen enumlar** (skaler değerler ile) veritabanları ve serileştirme ile temiz bir şekilde entegre olur (`from()`/`tryFrom()` dönüştürme için), ve enumlar **metotlara** sahip olabilir (her duruma davranış ekler, örneğin `label()` veya `isActive()`), bu da onları domain modeling için güçlü kılıyor.

Saf ve desteklenen enumları, bunların metotlarını ve eski hata eğilimli constant/string yaklaşımının yerine nasıl geçtiklerini anlamak, modern, tür-güvenli PHP yazabilmek için önemli bilgidir — çünkü enumlar artık sabit değer setlerini modellemek için idiyomatik yol olmuştur ve güncel çerçevelerde ve uygulamalarda yaygın olarak kullanılmaktadır. Bunları ustalaşmak, modern PHP konusunda akıcılığı ve geçersiz değer hatalarının bütün bir sınıfını önleyen, daha güvenli, daha ifadeci, kendi kendine açıklayıcı kod yazma yeteneğini yansıtır.