Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 57 – Enums (PHP 8.1)

PHP 8.1 ile gelen Enum yapısını, backed enum, cases() ve match ifadesiyle kullanımını adım adım öğrenin. Gerçek örnekler ve sık yapılan hatalarla pekiştirin.

Ders 57 – Enums (PHP 8.1)

PHP 8.1 sürümü, dilin en çok beklenen özelliklerinden biri olan Enum (enumeration) yapısını tanıttı. Enumlar, sabit değer kümelerini tip güvenli bir şekilde tanımlamamızı sağlar; böylece kod okunurluğu artar, hatalar erken aşamada yakalanır ve switch/match gibi kontrol yapılarıyla daha temiz bir kullanım elde ederiz. Bu dersimizde, backed enum kavramını, cases() metodunu ve match ifadesiyle entegrasyonunu detaylıca inceleyeceğiz.

Temeller

Enum, bir sınıf gibi tanımlanır ancak sadece sabit case tanımları içerir. PHP'de iki tip enum vardır:

  • Pure enum: Sadece case tanımlar; değer taşımaz.
  • Backed enum: int ya da string tipinde bir değer (value) taşır.

Backed enum, dış veri (ör. API yanıtı, veritabanı) ile doğrudan eşleşme yapmamıza olanak tanır. Enum tanımı şu şekilde yapılır:

enum Durum: string {
    case Acik = "acik";
    case Kapali = "kapali";
    case Beklemede = "beklemede";
}

Yukarıdaki örnekte Durum enumu string tipinde bir değer taşır. Her case bir sabit ad (ör. Acik) ve ona karşılık gelen value (ör. "acik") içerir.

Backed Enum ve Value Özelliği

Backed enumların en önemli özelliği value alanıdır. Bir enum örneği oluşturduğunuzda, ->value ile tanımlı değere ulaşabilirsiniz:

$durum = Durum::Acik;
echo $durum->value; // çıktısı: acik

Bu sayede, dışarıdan gelen bir string'i doğrudan enum tipine dönüştürmek mümkündür. PHP 8.1, from() ve tryFrom() adında iki yardımcı metot sunar:

  • Durum::from('acik') – geçerli bir değer ise enum örneği döner, aksi takdirde ValueError fırlatır.
  • Durum::tryFrom('acik') – geçerli bir değer ise enum örneği döner, geçersiz ise null döner.

Bu iki metod, kullanıcı girdilerini doğrularken çok işe yarar.

Adım Adım Kullanım

Aşağıda, bir web uygulamasında sipariş durumlarını yönetmek için enum kullanımını adım adım gösteren bir senaryo bulunuyor.

  1. Enum Tanımı: Sipariş durumlarını temsil eden bir backed enum oluşturun.
  2. Veri Katmanı: Veritabanından gelen status alanı string olarak alınır.
  3. Dönüştürme: Durum::tryFrom() ile string'i enum tipine çevirin.
  4. İş Mantığı: match ifadesiyle enum değerine göre farklı işlemler yürütün.

Bu adımları kodla birleştirelim:

enum SiparisDurumu: string {
    case Olusturuldu = "olusturuldu";
    case OdemeAlindi = "odeme_alindi";
    case KargoyaVerildi = "kargoya_verildi";
    case Tamamlandi = "tamamlandi";
    case Iptal = "iptal";
}

function siparisIsle(string $statusString): void {
    $durum = SiparisDurumu::tryFrom($statusString);
    if ($durum === null) {
        echo "Geçersiz sipariş durumu: $statusString\n";
        return;
    }

    $mesaj = match($durum) {
        SiparisDurumu::Olusturuldu => "Siparişiniz oluşturuldu, ödeme bekleniyor.",
        SiparisDurumu::OdemeAlindi => "Ödeme alındı, hazırlık sürecine geçildi.",
        SiparisDurumu::KargoyaVerildi => "Siparişiniz kargoya verildi.",
        SiparisDurumu::Tamamlandi => "Siparişiniz tamamlandı, teşekkür ederiz!",
        SiparisDurumu::Iptal => "Siparişiniz iptal edildi.",
    };
    echo $mesaj . "\n";
}

// Örnek çağrılar
siparisIsle("odeme_alindi");
siparisIsle("bilinmeyen");

Bu örnek, enumların match ile nasıl daha okunabilir bir kontrol akışı sağladığını gösterir. match, switch'e göre daha sıkı tip kontrolü yapar ve her durumun ele alındığından emin olur.

Match İle Enums Kullanımı

match ifadesi, PHP 8.0 ile gelen ve switch'e kıyasla aşağıdaki avantajları sunan bir yapıdı:

  • Tip güvenliği (===) kullanır.
  • Değer döndürebilir; break ihtiyacı yoktur.
  • Varsayılan (default) durumunu default anahtar kelimesiyle belirtir.

Enumlar ile match kullanırken, enum örneklerini doğrudan karşılaştırabiliriz. Örneğin:

enum Renk: string { case Kirmizi = "kirmizi"; case Yesil = "yesil"; case Mavi = "mavi"; }

function renkAciklamasi(Renk $renk): string {
    return match($renk) {
        Renk::Kirmizi => "Ateşin rengi.",
        Renk::Yesil => "Doğanın rengi.",
        Renk::Mavi => "Gökyüzünün rengi.",
    };
}

echo renkAciklamasi(Renk::Mavi); // çıktısı: Gökyüzünün rengi.

Burada match ifadesi, enumun her bir casei için ayrı bir yol tanımlar ve eksik bir case bırakıldığında UnhandledMatchError fırlatır. Bu da kodun eksiksiz olmasını zorunlu kılar.

Sık Karşılaşılan Hatalar

Enumları kullanırken yeni başlayanların sık yaptığı hatalar şunlardır:

  • Value eksikliği: Backed enum tanımlarken casee bir value atamamak ParseError verir.
  • Yanlış tip dönüşümü: int backed enum için string değer vermek TypeError oluşturur.
  • cases() metodunu unutmak: Enum sınıflarında cases() statik bir metod olarak tüm case'leri dizi olarak döndürür; bu metodun eksik kullanımı dinamik menülerde sorun yaratır.
  • match içinde eksik case: match ifadesinde bir enum case'i atlanırsa UnhandledMatchError fırlatılır.

Bu hataları önlemek için aşağıdaki kontrol listesini uygulayın.

  • Backed enum tanımlarken casee uygun string ya da int değer atayın.
  • Gelen dış veriyi Enum::tryFrom() ile doğrulayın; null dönerse hata mesajı gösterin.
  • Enum sınıflarında cases() metodunu kullanarak dinamik bir seçenek listesi oluşturun.
  • match ifadesinde tüm enum case'lerini kapsadığınızdan emin olun; gerekirse default ekleyin.

Özet

PHP 8.1'in enum özelliği, sabit değer kümelerini tip güvenli bir şekilde yönetmemizi sağlar. Backed enumlar, dış sistemlerle (API, DB) entegrasyonu basitleştirirken, cases() metodu tüm case'leri elde etmemize, match ifadesi ise temiz ve hatasız bir kontrol akışı sunar. Doğru kullanım için:

  • Enum tanımını doğru tip ve değerlerle yapın.
  • Girdi doğrulama için from() ve tryFrom() metodlarını tercih edin.
  • Enum case'lerini dinamik olarak listelemek için EnumName::cases() kullanın.
  • Kontrol akışlarında match ile eksiksiz case kapsamı sağlayın.

Bu prensipleri uyguladığınızda, kodunuz daha okunur, bakım maliyetleri düşer ve hatalar erken aşamada yakalanır.

SSS

Soru 1: Backed enum ile pure enum arasındaki temel fark nedir?

Cevap: Backed enum bir int ya da string değer taşırken, pure enum sadece sabit adları (case) içerir ve değer taşımaz.

Soru 2: Enum::from() ve Enum::tryFrom() ne zaman tercih edilmelidir?

Cevap: Kullanıcı girdisi kesinlikle geçerli bir değer ise from() kullanılabilir; aksi takdirde ValueError fırlatır. Girdi geçersiz olma ihtimali varsa tryFrom() tercih edilerek null kontrolü yapılmalıdır.

Soru 3: match ifadesinde bir enum case'i unutursam ne olur?

Cevap: PHP UnhandledMatchError fırlatır, bu da eksik case'in fark edilmesini sağlar.

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

PHP serisinin son dersinde ileri seviye konular, framework seçimi, Composer ekosistemi, mikro pro…

Ders 99 – Güvenli yapılandırma kontrol listesi

Üretim ortamı için PHP yapılandırma ayarlarını adım adım kontrol eden, hatasız ve güvenli bir yap…

Ders 98 – OpCache ve performans ipuçları

OpCache'ın çalışma prensibi, yapılandırma adımları ve gerçek dünyada performans artırmak için pra…

Ders 97 – Fibers’a kısa bakış (PHP 8.1)

PHP 8.1 ile gelen Fibers özelliğini adım adım öğrenin, kooperatif concurrency kavramını kavrayın …

Demo
Büyütülmüş Görsel