Declaración de tipos escalares y tipos de retorno en PHP
Nuevas características de PHP 7
Declaración de tipos escalares
De forma predeterminada, todos los archivos PHP están en modo de comprobación de tipos débil.
PHP 7 añade la característica de declaración de tipos escalares, que tiene dos modos:
- Modo coercitivo (predeterminado)
- Modo estricto
Formato de sintaxis de la declaración de tipos escalares:
declare(strict_types=1);
En el código, especificando el valor de strict_types (1 o 0), 1 indica el modo de comprobación de tipos estricto, que se aplica a las llamadas a funciones y a las declaraciones de retorno; 0 indica el modo de comprobación de tipos débil.
Los parámetros de tipo que se pueden usar son:
int
float
bool
string
interfaces
array
callable
Ejemplo de modo coercitivo
Ejemplo
// Modo coercitivo
function sum(int ...$ints)
{
return array_sum($ints);
}
print(sum(2, '3', 4.1));
?>
El resultado de la ejecución del programa anterior es:
9
En el ejemplo, el parámetro 4.1 se convierte en el entero 4 y luego se suma.
Ejemplo de modo estricto
Ejemplo
// Modo estricto
declare(strict_types=1);
function sum(int ...$ints)
{
return array_sum($ints);
}
print(sum(2, '3', 4.1));
?>
Como el programa anterior usa el modo estricto, si en los parámetros aparece un tipo que no sea entero, se producirá un error. El resultado de la ejecución es:
PHP Fatal error: Uncaught TypeError: Argument 2 passed to sum() must be of the type integer, string given, called in……
Declaración de tipos de retorno
PHP 7 añade soporte para la declaración de tipos de retorno, que especifica el tipo del valor de retorno de una función.
Los tipos de retorno que se pueden declarar son:
int
float
bool
string
interfaces
array
callable
Ejemplo de declaración de tipo de retorno
En el ejemplo, se requiere que el resultado devuelto sea un entero:
Ejemplo
declare(strict_types=1);
function returnIntValue(int $value): int
{
return $value;
}
print(returnIntValue(5));
?>
El resultado de la ejecución del programa anterior es:
5
Ejemplo de error en la declaración de tipo de retorno
Ejemplo
<?php
declare(strict_types=1);
function returnIntValue(int $value): int
{
return $value + 1.0;
}
print(returnIntValue(5));
?>
Ejemplo
declare(strict_types=1);
function returnIntValue(int $value): int
{
return $value + 1.0;
}
print(returnIntValue(5));
?>
Debido al modo estricto en el programa anterior, el valor de retorno debe ser int, pero el resultado del cálculo es float, por lo que se producirá un error. El resultado de la ejecución es:
Fatal error: Uncaught TypeError: Return value of returnIntValue() must be of the type integer, float returned...
Funciones void
Se ha introducido un nuevo tipo de retorno void. Los métodos cuyo tipo de retorno se declara como void deben omitir la declaración return o utilizar una declaración return vacía. Para las funciones void, NULL no es un valor de retorno válido.También existe el tipo de retorno void. Una función con tipo de retorno void no puede tener un valor de retorno, ni siquiera devolver null.
Las funciones void pueden omitir la declaración return o utilizar una declaración return vacía.
Ejemplo
function swap(&$left, &$right) : void
{
if ($left === $right) {
return;
}
$tmp = $left;
$left = $right;
$right = $tmp;
}
$a = 1;
$b = 2;
var_dump(swap($a, $b), $a, $b);
El resultado del ejemplo anterior es:
null int(2) int(1)
Otras extensiones