Covariance et Contravariance
À partir de PHP 7.2.0, la contravariance partielle a été introduite en supprimant les restrictions de type
sur les paramètres d'une méthode enfant. À partir de PHP 7.4.0, la covariance et la contravariance complètes
ont été ajoutées.
La covariance permet à une méthode enfant de retourner un type plus spécifique que le type de retour
de sa méthode parente. La contravariance permet à un type de paramètre d'être moins spécifique
dans une méthode enfant que dans celui de la méthode parente.
Une déclaration de type est considérée comme plus spécifique dans le cas suivant :
Un type de classe est considéré moins spécifique si l'inverse est vrai.
Covariance
Pour illustrer le fonctionnement de la covariance, une simple classe parente abstraite, Animal
est créée. Animal sera étendu par des classes enfants,
Cat et Dog.
Notez qu'il n'y a pas de méthodes qui renvoient des valeurs dans cet exemple. Quelques fabriques
seront ajoutées et renverront un nouvel objet de classe de type Animal,
Cat, ou Dog.
Contravariance
En reprenant l'exemple précédent avec les classes Animal,
Cat et Dog, deux classes appelées
Food et AnimalFood sont incluses, et
une méthode eat(AnimalFood $food) est ajoutée à la classe abstraite
Animal .
Afin de voir le comportement de la contravariance, la méthode
méthode eat est surchargée dans la classe Dog afin d'autoriser
n'importe quel objet de type Food. La classe Cat reste inchangée.
L'exemple suivant montre le comportement de la contravariance.
Variation de type des propriétés
Par défaut, les propriétés ne sont ni covariantes ni contravariantes, donc invariantes.
Autrement dit, leur type ne peut pas du tout changer dans une classe enfant.
La raison en est que les opérations "get" doivent être covariantes,
et les opérations "set" doivent être contravariantes.
La seule façon pour une propriété de satisfaire ces deux exigences est d'être invariante.
À partir de PHP 8.4.0, avec l'ajout des propriétés abstraites (sur une interface ou une classe abstraite) et
propriétés virtuelles,
il est possible de déclarer une propriété qui n'a qu'une opération "get" ou "set".
En conséquence, les propriétés abstraites ou les propriétés virtuelles qui n'ont que l'opération "get" requise peuvent être covariantes.
De même, une propriété abstraite ou une propriété virtuelle qui n'a que l'opération "set" requise peut être contravariante.
Cependant, une fois qu'une propriété a à la fois une opération "get" et "set",
elle n'est plus covariante ni contravariante pour une extension future.
Autrement dit, elle devient désormais invariante.
Exemple #1 Variation du type des propriétés
<?php
class Animal {}
class Dog extends Animal {}
class Poodle extends Dog {}
interface PetOwner
{
// Seule l'opération "get" est requise, donc cela peut être covariant.
public Animal $pet { get; }
}
class DogOwner implements PetOwner
{
// Cela peut être un type plus restrictif, car le côté "get"
// retourne toujours un Animal. Cependant, en tant que propriété native,
// les enfants de cette classe ne peuvent plus changer le type.
public Dog $pet;
}
class PoodleOwner extends DogOwner
{
// Ceci N'EST PAS AUTORISÉ, car DogOwner::$pet a à la fois
// les opérations "get" et "set" définies et requises.
public Poodle $pet;
}
?>