PHP 8’de Öznitelikler (Attributes): Sözdizimi ve Kullanımı

[XxZeMaHSeRxX]

HERAKLES Otomatik Avlı kalıcı sunucu. 19 Haziran'da açılıyor. Atius & Wizard güvencesiyle hemen kayıt ol, ön kayıt ödülleri aktif. HEMEN TIKLA!

1. Öznitelik (Attribute) Nedir?​

PHP 8 ile birlikte gelen Attributes (Öznitelikler) özelliği, sınıflara, metodlara, özelliklere (properties), fonksiyonlara veya parametrelere meta veri (ek bilgi) eklemeyi sağlar.

Bu, PHPDoc yorumları veya harici açıklama sistemleri yerine artık yerleşik bir PHP özelliği olarak kullanılabilir.
​

2. Özniteliklerin Amacı​

Öznitelikler, bir koda ek anlam veya davranış bilgisi kazandırmak için kullanılır.
Bu bilgiler genellikle framework’ler, kütüphaneler veya sistemler tarafından okunur ve işlenir.

Örnek kullanım alanları:

Bir sınıfı belirli bir route (URL) ile ilişkilendirmek.
ORM sistemlerinde (örneğin Doctrine) tablo sütunlarını tanımlamak.
Test veya güvenlik açıklamaları eklemek.
​

3. PHP 8 Öncesi Durum​

PHP 8’den önce bu tür meta veriler genellikle yorum satırlarında PHPDoc şeklinde yazılırdı:

/**
 * @Route("/users", methods={"GET"})
 */
class UserController {
    // ...
}

Bu yaklaşımda PHP’nin yorumları yorumlayabilmesi için harici bir parser (yorum okuyucu) kullanılması gerekiyordu.
​

4. PHP 8’de Öznitelik Sözdizimi​

PHP 8 ile artık öznitelikler #[...] biçiminde doğrudan kodun içine yazılabilir.

Örnek:

#[Route('/users', methods: ['GET'])]
class UserController {
    // ...
}

Buradaki #[Route(...)] bir özniteliktir ve PHP tarafından okunabilir meta veri olarak kabul edilir.
​

5. Temel Sözdizimi​

#[AttributeAdı(argüman1: değer1, argüman2: değer2)]

Örnekler:

#[Loggable]
#[Table(name: "users")]
#[Column(type: "string", length: 255)]

Birden fazla öznitelik aynı yere yazılabilir:

#[Serializable, Deprecated]
class EskiSinif {}
​

6. Öznitelik Tanımlama​

Kendi özel özniteliklerinizi de oluşturabilirsiniz.
Bunun için #[Attribute] özniteliğiyle işaretlenmiş bir sınıf tanımlanır.

Örnek:

#[Attribute]
class Route {
public function __construct(
public string $path,
public array $methods = ['GET']
) {}
}

Bu tanımdan sonra bu özniteliği kullanabilirsiniz:

#[Route('/home', methods: ['GET', 'POST'])]
class HomeController {}​

 

[Lightning]

Paylaşım için teşekkürler

 

[ByMoDuS]

Paylaşım için teşekkürler.