Sayfa yükleniyor

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

Ders 96 – Attributes (PHP 8)

PHP 8 ile gelen Attributes (Öznitelikler) sayesinde sınıf, metod ve özelliklere meta veri ekleyebilir, Reflection ile okuyarak modern bir yapı oluşturabilirsiniz.

Ders 96 – Attributes (PHP 8)

PHP 8, dilin en büyük yeniliklerinden biri olan Attributes (Öznitelikler) özelliğini tanıttı. Bu özellik, eski zamanların docblock yorumlarıyla (annotation) yapılan meta veri tanımlamalarını daha güvenli, tip kontrollü ve performanslı bir hâle getiriyor. Attributes sayesinde bir sınıfa, metoda ya da özelliğe doğrudan PHP kodu içinde bilgi ekleyebilir, bu bilgiyi Reflection API'siyle okuyarak dinamik davranışlar oluşturabilirsiniz. Bu ders, Attributes'un temellerini, nasıl tanımlanacağını, Reflection ile nasıl okunacağını ve gerçek dünyada nasıl kullanılacağını adım adım anlatıyor.

Attributes Nedir?

Attributes, #[] sözdizimiyle tanımlanan, PHP kodunun üzerine yerleştirilen meta verilerdir. Bir sınıf, metod, özellik, parametre ya da sabit üzerine eklenebilir. Örneğin:

#\Route("/urunler")
class UrunController {}

Yukarıdaki örnekte Route adında bir attribute, UrunController sınıfına eklenmiştir. Attribute sınıfları Attribute arayüzünü (PHP 8'de #[Attribute] olarak işaretlenir) uygulamalıdır ve birden fazla parametre alabilir.

Temel Kullanım

Öncelikle bir attribute sınıfı tanımlamalıyız. Attribute sınıfları Attribute arayüzünü uygular ve #[Attribute] ile işaretlenir. Aşağıdaki örnek, bir Route attribute'unun nasıl tanımlandığını gösterir:

#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
class Route
{
    public string $path;
    public string $method;
    public function __construct(string $path, string $method = "GET")
    {
        $this->path = $path;
        $this->method = $method;
    }
}

Bu attribute, sınıf ya da metod seviyesinde kullanılabilir (Attribute::TARGET_CLASS ve Attribute::TARGET_METHOD bayrakları sayesinde).

Reflection ile Attributes Okuma

Attributes tanımlandıktan sonra, ReflectionClass, ReflectionMethod vb. sınıflar aracılığıyla bu meta verilere erişebiliriz. Aşağıdaki örnek, bir sınıfa eklenmiş Route attribute'unu nasıl okuyacağımızı gösterir:

$refClass = new ReflectionClass(UrunController::class);
$attributes = $refClass->getAttributes(Route::class);
foreach ($attributes as $attr) {
    /** @var Route $instance */
    $instance = $attr->newInstance();
    echo "Path: {$instance->path}, Method: {$instance->method}\n";
}

Bu kod, UrunController sınıfına eklenmiş tüm Route attribute'larını alır, her birini nesneye dönüştürür ve tanımlı path ve method değerlerini ekrana yazar.

Uygulama Örneği

Aşağıda, bir mini MVC router'ı nasıl oluşturabileceğinizi gösteren tam bir örnek bulunmaktadır. Bu örnek, iki attribute'lu bir kontrolcü sınıfı tanımlar, tüm kontrolcüleri tarar ve gelen HTTP isteğine göre uygun metodu çağırır.

#[Attribute(Attribute::TARGET_CLASS)]
class Controller {}

#[Attribute(Attribute::TARGET_METHOD)]
class Route
{
    public string $path;
    public string $method;
    public function __construct(string $path, string $method = "GET")
    {
        $this->path = $path;
        $this->method = $method;
    }
}

#[Controller]
class UrunController
{
    #[Route("/urunler", "GET")]
    public function liste()
    {
        echo "Ürün listesi gösteriliyor...";
    }

    #[Route("/urun/ekle", "POST")]
    public function ekle()
    {
        echo "Yeni ürün ekleniyor...";
    }
}

function dispatch(string $uri, string $method)
{
    $controllers = [UrunController::class]; // gerçek projelerde otomatik tarama yapılır
    foreach ($controllers as $controllerClass) {
        $rc = new ReflectionClass($controllerClass);
        if (!$rc->getAttributes(Controller::class)) {
            continue; // Controller attribute'u yoksa atla
        }
        foreach ($rc->getMethods() as $methodRef) {
            $attrs = $methodRef->getAttributes(Route::class);
            foreach ($attrs as $attr) {
                /** @var Route $route */
                $route = $attr->newInstance();
                if ($route->path === $uri && strtoupper($route->method) === strtoupper($method)) {
                    $instance = $rc->newInstance();
                    $methodRef->invoke($instance);
                    return;
                }
            }
        }
    }
    http_response_code(404);
    echo "Sayfa bulunamadı";
}

// Örnek çağrı
dispatch('/urunler', 'GET');

Bu örnek, Controller ve Route attribute'larını kullanarak bir yönlendirme (routing) mekanizması oluşturur. dispatch fonksiyonu, gelen URI ve HTTP metodunu alır, tanımlı controller sınıfları içinde eşleşen attribute'u bulur ve ilgili metodu çalıştırır.

Sık Karşılaşılan Hatalar

  • Attribute sınıfının #[Attribute] ile işaretlenmemesi. Bu durumda PHP, sınıfı attribute olarak tanımaz ve bir ReflectionException fırlatır.
  • Yanlış hedef (target) bayrağı kullanmak. Örneğin, bir attribute sadece metod seviyesinde kullanılacak şekilde tanımlanmışsa sınıfa eklenmeye çalışıldığında ReflectionException alınır.
  • Attribute'un parametre sayısının eksik ya da tip uyumsuzluğu. Constructor'da tanımlı zorunlu parametreler sağlanmadığında ArgumentCountError ortaya çıkar.
  • Reflection ile attribute okurken newInstance() yerine getArguments() kullanmak, nesne oluşturulmadan sadece ham parametre dizisini verir ve tip güvenliğini kaybettirir.

Özet ve Kontrol Listesi

Attributes, PHP 8'de modern, tip güvenli ve performanslı bir meta veri mekanizması sunar. Doğru tanımlama, uygun hedef bayrakları ve Reflection ile okuma adımları takip edildiğinde, framework seviyesinde router, validator, serializer gibi pek çok senaryoyu basitleştirebiliriz.

  • Attribute sınıfınızı #[Attribute] ile işaretlediniz mi?
  • Hedef bayraklarını (TARGET_CLASS, TARGET_METHOD, vb.) ihtiyacınıza göre ayarladınız mı?
  • Constructor parametrelerini doğru tip ve sayıda tanımladınız mı?
  • Reflection ile attribute'ları okurken newInstance() kullandığınızdan emin misiniz?
  • Üretim ortamında hataları kullanıcıya doğrudan göstermek yerine loglayıp genelleyici bir mesaj döndürdünüz mü?

SSS

Soru 1: Attributes ve docblock annotation'lar aynı amaç için mi kullanılabilir?

Cevap: Evet, her iki yöntem de meta veri eklemek için kullanılabilir, ancak Attributes PHP tarafından derleme zamanında işlenir, tip kontrolü ve performans avantajı sağlar. Docblock yorumları ise yalnızca string olarak kalır, IDE ve üçüncü parti paketler tarafından yorumlanır.

Soru 2: Bir attribute birden fazla kez aynı hedefe eklenebilir mi?

Cevap: Evet. #[Attribute(Attribute::IS_REPEATABLE)] bayrağı eklenirse aynı sınıf/metod içinde bir attribute birden fazla kez kullanılabilir.

Soru 3: Attributes sadece PHP 8.0'da mı çalışır?

Cevap: Attributes PHP 8.0 ve üzeri sürümlerde mevcuttur. Daha eski sürümlerde docblock annotation'lar tek seçenek olur.

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