Déclarations du type de retour

Tout comme vous pouvez déclarer les types des paramètres, vous pouvez également spécifier quel type une function doit return. Les déclarations de type de return indiquent précisément à PHP quel type de valeur votre function renverra, ce qui aide à détecter les erreurs lorsqu’une function renvoie accidentellement le mauvais type.

Pour ajouter un type de retour, placez deux-points suivis du type après la parenthèse fermante de la liste des paramètres :

<?php
function add(int $a, int $b): int {
    return $a + $b;
}

echo add(5, 3);
?>

Cela affiche 8. Le : int après les parenthèses déclare que cette fonction doit retourner un entier. Si vous essayiez de retourner une chaîne à la place, PHP générerait une erreur.

Vous pouvez utiliser les mêmes types que pour les déclarations de paramètres : int, float, string, bool et array. Il existe également un type spécial appelé void pour les fonctions qui ne renvoient rien :

<?php
function sayHello(string $name): void {
    echo "Hello, $name!\n";
}

sayHello("Alice");
?>

Une fonction void ne peut pas contenir d’instruction return avec une valeur. La combinaison des types de paramètres et des types de retour rend vos fonctions auto-documentées : toute personne qui lit le code sait immédiatement ce qui y entre et ce qui en sort.