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
casetanımlar; değer taşımaz. - Backed enum:
intya dastringtipinde 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 takdirdeValueErrorfırlatır.Durum::tryFrom('acik')– geçerli bir değer ise enum örneği döner, geçersiz isenulldö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.
- Enum Tanımı: Sipariş durumlarını temsil eden bir backed enum oluşturun.
- Veri Katmanı: Veritabanından gelen
statusalanı string olarak alınır. - Dönüştürme:
Durum::tryFrom()ile string'i enum tipine çevirin. - İş Mantığı:
matchifadesiyle 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;
breakihtiyacı yoktur. - Varsayılan (default) durumunu
defaultanahtar 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 birvalueatamamakParseErrorverir. - Yanlış tip dönüşümü:
intbacked enum için string değer vermekTypeErroroluş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:
matchifadesinde bir enum case'i atlanırsaUnhandledMatchErrorfırlatılır.
Bu hataları önlemek için aşağıdaki kontrol listesini uygulayın.
- Backed enum tanımlarken
casee uygunstringya daintdeğer atayın. - Gelen dış veriyi
Enum::tryFrom()ile doğrulayın;nulldönerse hata mesajı gösterin. - Enum sınıflarında
cases()metodunu kullanarak dinamik bir seçenek listesi oluşturun. matchifadesinde tüm enum case'lerini kapsadığınızdan emin olun; gerekirsedefaultekleyin.
Ö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()vetryFrom()metodlarını tercih edin. - Enum case'lerini dinamik olarak listelemek için
EnumName::cases()kullanın. - Kontrol akışlarında
matchile 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.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.