Interfaces
Les interfaces objet vous permettent de créer du code qui spécifie quelles
méthodes une classe doit implémenter, sans avoir à définir comment ces méthodes
fonctionneront. Les interfaces partagent l'espace de nom avec les classes
et les traits, donc elles ne peuvent pas utiliser le même nom.
Les interfaces sont définies de la même façon que pour une classe, mais en
utilisant le mot-clé interface
à la place de
class
, et sans qu'aucune des méthodes n'ait son contenu
de spécifié.
De par la nature même d'une interface, toutes les méthodes déclarées dans une
interface doivent être publiques.
En pratique les interfaces servent deux rôles complémentaires :
-
Permettre aux développeurs de créer des objets de classes différentes
qui peuvent être utilisé de façon interchangeable car elles implémentes
la ou les mêmes interfaces. Un exemple commun sont plusieurs services
d'access à des bases de données, plusieurs gestionnaire de paiement, ou
différentes stratégies de cache. Différentes implémentations peuvent être
échanger sans nécessiter des changements dans le code qui les utilisent.
-
Pour permettre à une fonction ou méthode d'accepter et opérer sur un
paramètre qui conforme à une interface, sans se soucier de quoi d'autre
l'objet peut faire ou comment c'est implémenté. Ces interfaces sont souvent
nommées
Iterable
, Cacheable
, Renderable
,
etc. pour décrire la signification de leur comportement.
Les interfaces peuvent définir des
méthodes magiques pour obliger
les classes implémentant à implémenter ces méthodes.
Note:
Tant bien que c'est supporté, inclure les
constructeurs
dans les interfaces et fortement déconseillé. Faire ceci réduit
drastiquement la flexibilité des objets implémentant l'interface.
De plus, les constructeurs ne sont pas enforcé par les règles d'héritage,
ce qui peut causer des inconsistances et des comportements inattendue.
implements
Pour implémenter une interface, l'opérateur implements
est utilisé. Toutes les méthodes de l'interface doivent être implémentées dans une
classe ; si ce n'est pas le cas, une erreur fatale sera émise. Les classes peuvent
implémenter plus d'une interface, en séparant chaque interface par une virgule.
Avertissement
Une classe peut implémenter deux interfaces qui définissent une méthode
avec le même nom, seulement si la déclaration de la méthode est identique
dans les deux interfaces est identique.
Avertissement
Une classe qui implémente une interface peut utiliser des noms différents
pour ses paramètres que l'interface. Cependant, à partir de PHP 8.0, le
langage supporte les
arguments nommés, ce qui
signifie que l'appeleur peut dépendre du nom du paramètre dans l'interface.
Pour cette raison, il est fortement recommandé que les développeurs
utilisent le même nom de paramètre que dans l'interface qui est implémenté.
Note:
Les interfaces peuvent être étendues comme des classes, en utilisant l'opérateur
extends
Note:
La classe implémentant l'interface doit déclarer toutes les méthodes dans
l'interface avec une signature compatible.
Les constantes
Les interfaces peuvent contenir des constantes. Les constantes d'interfaces fonctionnent exactement
comme les constantes de classe, mis à part le fait
qu'elles ne peuvent pas être écrasées par une classe ou une interface qui en hérite.
Exemples
Exemple #1 Exemple d'interface
<?php
// Declaration de l'interface 'Template'
interface Template
{
public function setVariable($name, $var);
public function getHtml($template);
}
// Implémentation de l'interface
// Ceci va fonctionner
class WorkingTemplate implements Template
{
private $vars = [];
public function setVariable($name, $var)
{
$this->vars[$name] = $var;
}
public function getHtml($template)
{
foreach($this->vars as $name => $value) {
$template = str_replace('{' . $name . '}', $value, $template);
}
return $template;
}
}
// Ceci ne fonctionnera pas
// Fatal error: Class BadTemplate contains 1 abstract methods
// and must therefore be declared abstract (Template::getHtml)
class BadTemplate implements Template
{
private $vars = [];
public function setVariable($name, $var)
{
$this->vars[$name] = $var;
}
}
?>
Exemple #2 Les interfaces extensibles
<?php
interface A
{
public function foo();
}
interface B extends A
{
public function baz(Baz $baz);
}
// Ceci fonctionnera
class C implements B
{
public function foo()
{
}
public function baz(Baz $baz)
{
}
}
// Ceci ne fonctionnera pas et entrainera une erreur fatale
class D implements B
{
public function foo()
{
}
public function baz(Foo $foo)
{
}
}
?>
Exemple #3 Héritage de plusieurs interfaces
<?php
interface A
{
public function foo();
}
interface B
{
public function bar();
}
interface C extends A, B
{
public function baz();
}
class D implements C
{
public function foo()
{
}
public function bar()
{
}
public function baz()
{
}
}
?>
Exemple #4 Interfaces avec des constantes
<?php
interface A
{
const B = 'Constante de l\'interface';
}
// Affiche : Constante de l'interface
echo A::B;
// Par contre, ceci ne fonctionnera pas, puisqu'il n'est pas permis
// d'écraser des constantes.
class B implements A
{
const B = 'Constante de classe';
}
?>
Exemple #5 Les interfaces avec les classes abstraites
<?php
interface A
{
public function foo(string $s): string;
public function bar(int $i): int;
}
// An abstract class may implement only a portion of an interface.
// Classes that extend the abstract class must implement the rest.
abstract class B implements A
{
public function foo(string $s): string
{
return $s . PHP_EOL;
}
}
class C extends B
{
public function bar(int $i): int
{
return $i * 2;
}
}
?>
Exemple #6 Étendant et implémentant simultanément
<?php
class One
{
/* ... */
}
interface Usable
{
/* ... */
}
interface Updatable
{
/* ... */
}
// The keyword order here is important. 'extends' must come first.
class Two extends One implements Usable, Updatable
{
/* ... */
}
?>
Une interface, avec les déclarations de types, fournit une bonne manière
pour s'assurer qu'un objet particulier contient des méthodes particulières.
Voir l'opérateur instanceof et
les déclarations de type.