Attributes

Définition

Métadonnées structurées ajoutées au code via #[...], introduites en PHP 8.0. Elles remplacent les annotations en commentaires par une syntaxe native. Le langage fournit désormais ses propres attributs : #[\Override] (PHP 8.3), #[\Deprecated] (PHP 8.4) et #[\NoDiscard] (PHP 8.5).

Analogie

Comme des étiquettes collées sur des boites : elles décrivent le contenu sans le modifier.

Exemple de code

#[Route('/api/users', methods: ['GET'])]
class UserController {
  #[Cache(ttl: 3600)]
  public function list(): Response {
    // ...
  }
}

Cas d'usage

Configuration déclarative (routes, validation, mapping ORM) et signaux au moteur ou aux outils : méthode surchargée, fonction dépréciée, valeur de retour à ne pas ignorer.

Anti-pattern

Termes liés

Sources

• php.net/releases/8.3/en.php
• php.net/releases/8.4/en.php
• php.net/releases/8.5/en.php