#[\Deprecated]

Définition

Attribut natif de PHP 8.4 qui marque une fonction, une méthode, une constante de classe ou un cas d'enum comme déprécié. À l'appel, le moteur émet un E_USER_DEPRECATED avec le message et la version (since) fournis ; la réflexion expose isDeprecated().

Analogie

L'étiquette « bientôt retiré de la vente » sur un produit encore en rayon.

Exemple de code

class PhpVersion
{
  #[\Deprecated(
    message: "utilisez getVersion() à la place",
    since: "8.4",
  )]
  public function getPhpVersion(): string
  {
    return $this->getVersion();
  }
}
// Appel : Deprecated: Method PhpVersion::getPhpVersion()
// is deprecated since 8.4, utilisez getVersion() à la place

Cas d'usage

Faire évoluer une API publique de bibliothèque sans casser les utilisateurs, avec un signal uniforme pour les IDE et l'analyse statique.

Anti-pattern

Termes liés

Sources

• php.net/releases/8.4/en.php
• wiki.php.net/rfc/deprecated_attribute