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

XxZeMaHSeRxX · 19 Eki 2025

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ı:

Kod:

/**
 * @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:

Kod:

#[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 {}