Declaraciones del tipo de retorno

Al igual que puedes declarar tipos para los parámetros, también puedes especificar qué tipo debe devolver una función. Las declaraciones del tipo de retorno indican a PHP exactamente qué clase de valor devolverá tu función, lo que ayuda a detectar errores cuando una función devuelve accidentalmente el tipo incorrecto.

Para añadir un tipo de retorno, coloca dos puntos seguidos del tipo después del paréntesis de cierre de la lista de parámetros:

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

echo add(5, 3);
?>

Esto muestra 8. El : int después de los paréntesis declara que esta función debe devolver un entero. Si intentaras devolver una cadena en su lugar, PHP produciría un error.

Puedes usar los mismos tipos que en las declaraciones de parámetros: int, float, string, bool y array. También existe un tipo especial llamado void para las funciones que no devuelven nada:

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

sayHello("Alice");
?>

Una función void no puede tener una instrucción return con un valor. Combinar los tipos de parámetros con los tipos de retorno hace que tus funciones se documenten por sí mismas: cualquiera que lea el código sabe inmediatamente qué entra y qué sale.