La classe ReturnTypeWillChange

(PHP 8 >= 8.1.0)

Introduction

La plupart des méthodes internes non finales exigent désormais que les méthodes de surcharge déclarent un type de retour compatible, sinon un avis d'obsolescence est émis lors de la validation de l'héritage. Cela introduit une phase de type de retour provisoire : le moteur émet un avis d'obsolescence plutôt qu'une erreur fatale lorsque les types de retour sont incompatibles, avant qu'ils ne soient imposés dans une version future. Dans le cas où le type de retour ne peut pas être déclaré pour une méthode de surcharge en raison de problèmes de compatibilité entre les versions de PHP, un attribut #[\ReturnTypeWillChange] peut être ajouté pour taire l'avis d'obsolescence.

Avertissement

L'attribut ReturnTypeWillChange supprime les avis d'obsolescence durant la phase de type de retour provisoire uniquement. Il n'a aucun effet lors de la surcharge de méthodes définies dans des classes définies par l'utilisateur. Une fois que les méthodes internes adopteront des types stricts, les incompatibilités dans les signatures des méthodes de surcharge provoqueront une erreur fatale et cet attribut n'aura plus aucun effet.

Synopsis de la classe

#[\Attribute]
final class ReturnTypeWillChange {
/* Méthodes */
public function __construct()
}

Sommaire